Весело
Весело

Картинки по API за рубли

Как нарисовать картинку по описанию через API: модели, пропорции, ссылки и base64. Примеры curl, Python и JavaScript, оплата в рублях.

Обновлено:

Отправь описание в POST https://veselo.ai/v1/images/generations — получишь готовую картинку в том же ответе. Здесь все нейросети Студии для картинок: Nano Banana, GPT Image, Qwen Image и Grok Imagine. Они рисуют одну картинку за запрос, а качество выбирается полем quality — от него зависит цена. Ответ ждёт картинку до 9 минут, обычно — секунды. Принимается только текст: правок по фото и стриминга пока нет.

Модели и цены

Картинки и цена за картинку — в рублях
idМодельЦена
google/nano-banana-2Nano Banana 2от 19,00 ₽ за картинку
google/nano-banana-proNano Banana Proот 29,00 ₽ за картинку
google/nano-banana-2.1Nano Banana 2.1от 9,00 ₽ за картинку
google/nano-banana-2-liteNano Banana 2 Liteот 9,00 ₽ за картинку
google/nano-bananaNano Bananaот 9,00 ₽ за картинку
openai/gpt-image-2.5-flareGPT Image 2.5 Flareот 9,00 ₽ за картинку
openai/gpt-image-2.5-sunburstGPT Image 2.5 Sunburstот 19,00 ₽ за картинку
openai/gpt-image-2GPT Image 2от 9,00 ₽ за картинку

В GET /v1/models выбирай записи с type: "image". У нейросетей Студии цена картинки по качеству — pricing_rub.per_image_quality ({"1K": …, "2K": …, "4K": …}), а качества — image.qualities. В pricing_rub.per_image — самая низкая цена за одну картинку. Поле image показывает доступные aspect_ratios, max_n и output_formats. Пустой output_formats означает, что формат выбирает модель. Модели с оплатой выхода в токенах и векторные модели пока недоступны.

Нарисовать картинку

curl

curl https://veselo.ai/v1/images/generations \
  -H "Authorization: Bearer $VESELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen/qwen-image-2.0",
    "prompt": "Рыжий кот на подоконнике, акварель, мягкий утренний свет",
    "size": "1024x1024",
    "n": 1
  }'

Python

import os
from openai import OpenAI  # pip install openai

client = OpenAI(
    base_url="https://veselo.ai/v1",
    api_key=os.environ["VESELO_API_KEY"],
    timeout=600.0,
    max_retries=0,
)
r = client.images.generate(
    model="qwen/qwen-image-2.0",
    prompt="Рыжий кот на подоконнике, акварель, мягкий утренний свет",
    size="1024x1024",
    n=1,
    response_format="url",
)
for picture in r.data:
    print(picture.url)
print("Цена:", r.model_dump()["usage"]["cost_rub"], "₽")

JavaScript

const res = await fetch('https://veselo.ai/v1/images/generations', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.VESELO_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'qwen/qwen-image-2.0',
    prompt: 'Рыжий кот на подоконнике, акварель, мягкий утренний свет',
    aspect_ratio: '1:1',
    n: 1,
  }),
  signal: AbortSignal.timeout(600_000),
});
const r = await res.json();
if (!res.ok) throw new Error(r.error.message);
for (const picture of r.data) console.log(picture.url);
console.log('Цена:', r.usage.cost_rub, '₽');

Ответ

{
  "created": 1794132000,
  "data": [{"url": "https://veselo.ai/media/api-images/2026-11-08/example.png"}],
  "usage": {"cost_rub": 5.68}
}

Цена и ссылка в примере условные. Ссылки находятся в data[].url, цена всего запроса — в usage.cost_rub и заголовке x-veselo-cost-rub. Для поддержки сохрани x-request-id.

Поля запроса

ПолеЧто передать
modelобязательно: id модели с type: image
promptобязательно: описание от 1 до 4000 знаков, не пустые пробелы
nцелое число от 1 до image.max_n, не больше 4; по умолчанию 1. У нейросетей Студии — только 1. Модель может вернуть меньше
qualityу нейросетей Студии: качество из image.qualities (1K, 2K, 4K, у Qwen — Стандарт/Pro…) или словами low, medium, high, auto. По умолчанию — как в Студии. От качества зависит цена
sizeШИРИНАxВЫСОТА, например 1024x1024 или 1792x1024. Выбирает ближайшие пропорции модели, точные пиксели не гарантируются
aspect_ratioвместо size: значение из image.aspect_ratios. По умолчанию 1:1, если доступно, иначе первый вариант модели
response_formaturl по умолчанию или b64_json — base64 в data[].b64_json, без сохранения у нас
output_formatpng, jpeg или webp из image.output_formats; без поля формат выбирает модель
seedцелое неотрицательное число до 9007199254740991, если seed есть в supported_parameters. Повтор результата не гарантируется

Передай либо size, либо aspect_ratio. Другие поля отвечают 400 с именем поля в param. Для aspect_ratio в Python SDK используй extra_body={"aspect_ratio": "16:9"} без size.

Удержание и списание

У нейросетей Студии API-счёт удерживает ровно цену картинки из per_image_quality и списывает её, когда картинка готова. Повтор с тем же Idempotency-Key и тем же телом вернёт ту же картинку без второго списания. Не дождались (504) или сервер обновлялся (503 — повтори через пару секунд) — денег не берём. У остальных моделей до генерации API-счёт удерживает цену n картинок с запасом ×1,5, а после — списывает цену каждой полученной картинки по прайсу. Размер на цену не влияет: цена — за картинку. Цена округляется вверх до копейки; остаток удержания освобождается. Ошибка ничего не стоит.

Лимиты общие с текстом: 60 запросов в минуту и 10 одновременных на ключ. Без Idempotency-Key повтор генерации — новый платный запрос. Подробнее о счёте — Цены и списания.

Ссылки и base64

Картинки по ссылкам хранятся у нас 7 дней. Скачай результат к себе до истечения срока. С response_format: "b64_json" сервер возвращает base64 без префикса data: и не сохраняет файл.

Если не получилось

HTTP / кодЧто сделать
400 / invalid_requestПроверь поле из param и возможности модели
401 / missing_api_key, invalid_api_keyПередай действующий ключ
402 / insufficient_balanceПополни счёт или уменьши n
403 / model_not_allowed, key_limit_reached, account_blockedВыбери доступную модель, проверь лимит ключа или обратись в поддержку
404 / model_not_foundВозьми id из GET /v1/models с type: image
422 / content_refusedПерепиши описание: проверка содержания его отклонила
429 / rate_limitedПодожди Retry-After секунд
502 / upstream_error; 503 / model_unavailable, api_disabled; 504 / upstream_timeoutПовтори позже или выбери другую модель

Все ошибки, включая 413 и 500, — в разделе Ошибки. Удержание при ошибке снимается без списания.

← Картинки во входе · Видео →

Вся документация одним текстом · Все модели и цены