---
title: "Картинки по API за рубли"
description: "Как нарисовать картинку по описанию через API: модели, пропорции, ссылки и base64. Примеры curl, Python и JavaScript, оплата в рублях."
url: https://veselo.ai/docs/images
updated: 2026-11-12T23:25:43.224Z
---

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

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

Обновлено: 13 ноября 2026 г.

Отправь описание в `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` повтор генерации — новый платный запрос. Подробнее о счёте — [Цены и списания](https://veselo.ai/docs/pricing).

## Ссылки и 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, — в разделе [Ошибки](https://veselo.ai/docs/errors). Удержание при ошибке снимается без списания.

[← Картинки во входе](https://veselo.ai/docs/vision) · [Видео →](https://veselo.ai/docs/video)

[Вся документация одним текстом](https://veselo.ai/docs/llms.txt) · [Все модели и цены](https://veselo.ai/models)

## Разделы документации

### Начало

- [Быстрый старт](https://veselo.ai/docs)
- [Ключи](https://veselo.ai/docs/auth)
- [Цены и списания](https://veselo.ai/docs/pricing)
- [Модели](https://veselo.ai/docs/models)

### Как сделать

- [Сообщения и параметры](https://veselo.ai/docs/chat)
- [Стриминг](https://veselo.ai/docs/streaming)
- [Вызов функций](https://veselo.ai/docs/tools)
- [Ответ в JSON](https://veselo.ai/docs/structured-output)
- [Провайдеры](https://veselo.ai/docs/providers)
- [Без цензуры](https://veselo.ai/docs/uncensored)
- [Картинки во входе](https://veselo.ai/docs/vision)
- **Картинки**
- [Видео](https://veselo.ai/docs/video)
- [Озвучка](https://veselo.ai/docs/speech)
- [Музыка](https://veselo.ai/docs/music)
- [SDK и программы](https://veselo.ai/docs/sdks)
- [Claude Code](https://veselo.ai/docs/anthropic)
- [Ключ для нейросети](https://veselo.ai/docs/agents)
- [MCP](https://veselo.ai/docs/mcp)

### Справочник

- [Методы API](https://veselo.ai/docs/reference)
- [Ошибки](https://veselo.ai/docs/errors)
- [Лимиты](https://veselo.ai/docs/limits)
- [Заголовки](https://veselo.ai/docs/headers)

### Ещё

- [Вопросы](https://veselo.ai/docs/faq)
- [Данные и приватность](https://veselo.ai/docs/privacy)
- [Изменения](https://veselo.ai/docs/changelog)
