Генерация изображения по тексту
Генерация изображений по текстовому промпту через API Cheapest Imagen: выбор модели, размера, качества, числа изображений и формата выходного файла.
Отправьте промпт на POST /v1/images/generations. Обязательны только model и prompt.
curl https://api.cheapestimagen.com/v1/images/generations \
-H "Authorization: Bearer $YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "a lighthouse at dusk, oil painting",
"n": 2,
"size": "1536x1024",
"quality": "high"
}'Параметры
| Поле | Что делает | Значения |
|---|---|---|
n | Число изображений | от 1 до 10, по умолчанию 1 |
size | Ширина и высота | auto или размер 1K, 2K или 4K, см. Соотношения и размеры |
quality | Качество отрисовки, цена одинакова | auto, low, medium, high; xhigh, max в gpt-image-2.5-sunburst |
background | Прозрачный или сплошной фон | auto, opaque, transparent |
output_format | Формат файла | png (по умолчанию), jpeg, webp на всех моделях; gif в gpt-image-2.6 и её вариантах flare и sunburst; svg в gpt-image-2.6 |
output_compression | Качество для jpeg и webp | от 0 до 100, по умолчанию 100 |
moderation | Насколько строги проверки контента | auto, low |
response_format | Данные изображения или ссылка | b64_json (по умолчанию), url |
Сейчас ни одна модель не делает прозрачный фон: OpenAI отозвала предварительную версию прозрачности для моделей GPT Image, и теперь они возвращают сплошной фон. Запрос с background: transparent возвращает 400 с кодом unsupported_parameter. Чтобы получить вырезанный объект, попросите в промпте однотонный фон одного цвета и удалите его потом.
Форматы вывода
PNG, JPEG и WebP работают на всех моделях, как в API OpenAI. Большинство моделей создают PNG, а мы преобразуем его в запрошенный JPEG или WebP внутри сети Cloudflare (примерно 0,1–0,4 секунды; PNG в 2 МБ превращается в JPEG или WebP около 250 КБ). gpt-image-2.6-flare и gpt-image-2.6-sunburst создают JPEG и WebP сами.
| Модель | PNG | JPEG | WebP | GIF | SVG |
|---|---|---|---|---|---|
gpt-image-2, gpt-image-2.5, gpt-image-2-adobe | Да | Да | Да | – | – |
gpt-image-2.6 | Да | Да | Да | Да | Да |
gpt-image-2.5-flare, gpt-image-2.5-sunburst | Да | Да | Да | – | – |
gpt-image-2.6-flare, gpt-image-2.6-sunburst | Да | Да | Да | Да | – |
| Nano Banana (все версии) | Да | Да | Да | – | – |
«–» возвращает 400. output_compression задаёт качество JPEG или WebP на всех моделях (по умолчанию 100). GIF может создаваться от трёх до пяти минут. Реальный тип файла указан в расширении ссылки и в её Content-Type.
Сколько кредитов тратит запрос
Запрос тратит n раз по стоимости модели в кредитах: 8 за изображение для GPT Image 2, 2.5 и 2.6, 12 для Nano Banana 2 и 2.1, 20 для Nano Banana Pro, gpt-image-2-adobe и вариантов flare, 25 для вариантов sunburst, от 60 до 180 для стабильных каналов Nano Banana. Если пришло меньше изображений, чем вы просили, вы платите только за полученные.
Повторная отправка того же запроса
Добавьте заголовок Idempotency-Key со значением на ваш выбор. Если тот же ключ приходит снова, пока первый запрос выполняется или после его успешного завершения, API отвечает 409 и ничего не создаёт и не списывает повторно. После неудачного запроса ключ можно использовать снова.
Быстрый старт
Сгенерируйте первое изображение через API Cheapest Imagen за три шага: создайте ключ, отправьте один запрос и прочитайте изображение из ответа.
Модели
Все ID моделей API Cheapest Imagen с официальной моделью OpenAI или Google, которая за ними стоит, создаваемыми разрешениями и ценой в кредитах за изображение.