GPT Image API: цена за картинку в рублях и подключение за 5 минут

Калькулятор стоимости

Выберите модель и объём — калькулятор считает по тем же формулам, что биллинг API.

Как подключить GPT Image API: первый запрос за 5 минут

От ключа до продакшена — шесть шагов по реальным контрактам /api/v1. Каждый шаг ведёт в нужный раздел документации.

1. 1

   Получите ключ в кабинете

   Зарегистрируйтесь, откройте раздел API в кабинете, пополните баланс в рублях и создайте ключ формата zc-sk-…. Один ключ открывает GPT Image и все остальные модели каталога.

   Подробнее →
2. 2

   Отправьте первый запрос

   POST /v1/images/generations с model, prompt и aspect или size — в ответе data[0].url с готовой картинкой GPT Image.

   Подробнее →
3. 3

   Сохраните результат и попробуйте правки

   Ссылка на картинку временная — сразу скачайте файл в своё хранилище. Для правок есть /v1/images/edits: до четырёх исходников по https-ссылке, data URI или multipart, до 8 МБ каждый.

   Подробнее →
4. 4

   Обработайте лимиты и ошибки

   30 запросов в минуту на ключ: на 429 подождите и повторите с нарастающей паузой; 402 — пополните баланс; 400 — сверьте model по GET /v1/models. Неудачная генерация не списывается, повторять её безопасно.

   Подробнее →
5. 5

   Следите за бюджетом

   GET /v1/balance отдаёт баланс и расход за 30 дней; цена каждого вызова приходит прямо в ответе — пишите её в свои логи и поставьте порог оповещения в своём мониторинге.

   Подробнее →
6. 6

   Выводите в продакшен

   Ключ храните в секретах сервера, не во фронтенде. Под большой объём GPT Image напишите нам — лимит поднимается индивидуально, юрлицам доступна оплата по счёту. Фактическую стабильность смотрите на странице статуса.

   Подробнее →

Входные материалы, лимиты и возврат денег

• Генерация: prompt + aspect 1:1 / 16:9 / 9:16 / 4:3 / 3:4 или size 1024x1024 / 1792x1024 / 1024x1792
• Редактирование: до 4 картинок — https-ссылки, data URI или multipart
• До 8 МБ на файл, до 48 МБ на запрос (иначе 413)
• Ссылка на результат временная — сохраняйте файл сразу
• Сбой провайдера — ничего не списывается
• 30 запросов в минуту на ключ (все ручки вместе)

Ответы с ошибками и возвраты

# 401 {"type":"error","error":{"type":"authentication_error","message":"Invalid or revoked API key."}}
# 402 {"type":"error","error":{"type":"billing_error","message":"Not enough API balance: …"}}
# 429 {"type":"error","error":{"type":"rate_limit_error","message":"…"}}   ← 30 requests/min per key
# 400 {"type":"error","error":{"type":"invalid_request_error","message":"Unknown model \"…\". See GET /v1/models."}}
# 413 {"type":"error","error":{"type":"invalid_request_error","message":"…"}}   ← > 8 MB per file / > 48 MB body
# 502 {"type":"error","error":{"type":"api_error","message":"…"}}                ← provider failed → nothing charged

Сценарии использования

Как готовить промт

• Опишите композицию по слоям: что на переднем плане, что на фоне, как расположены объекты друг относительно друга
• Задайте материалы и стиль явно: fotография, иллюстрация, 3D-рендер, акварель — это сильнее влияет на результат, чем общие эпитеты
• Укажите источник и направление света: мягкий рассеянный, жёсткий боковой, контровой — иначе модель выберет свет сама
• Выбирайте size или aspect под место размещения: 16:9 для обложек и баннеров, 9:16 для историй и мобильных экранов, 1:1 для карточек товара
• В edits формулируйте правку точечно: что заменить и что оставить без изменений, иначе модель может перерисовать всю сцену

Кому подходит GPT Image API

Отрасли, где этот тип генерации встраивается в процесс, а не остаётся экспериментом.