Перейти к содержимому
Cheapest Imagen
Руководства

Генерация изображения по тексту

Генерация изображений по текстовому промпту через 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 сами.

МодельPNGJPEGWebPGIFSVG
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 и ничего не создаёт и не списывает повторно. После неудачного запроса ключ можно использовать снова.

На этой странице