Картинки по 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-2 | Nano Banana 2 | от 19,00 ₽ за картинку |
google/nano-banana-pro | Nano Banana Pro | от 29,00 ₽ за картинку |
google/nano-banana-2.1 | Nano Banana 2.1 | от 9,00 ₽ за картинку |
google/nano-banana-2-lite | Nano Banana 2 Lite | от 9,00 ₽ за картинку |
google/nano-banana | Nano Banana | от 9,00 ₽ за картинку |
openai/gpt-image-2.5-flare | GPT Image 2.5 Flare | от 9,00 ₽ за картинку |
openai/gpt-image-2.5-sunburst | GPT Image 2.5 Sunburst | от 19,00 ₽ за картинку |
openai/gpt-image-2 | GPT 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_format | url по умолчанию или b64_json — base64 в data[].b64_json, без сохранения у нас |
output_format | png, 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, — в разделе Ошибки. Удержание при ошибке снимается без списания.