API картинок и видео

Картиночные модели (GPT Image, Nano Banana) оплачиваются за каждую картинку, а цена зависит от параметров. Цены и параметры конкретной модели смотрите на её странице в каталоге.

Генерация картинки

Запрос к POST /v1/images/generations:

bash

curl https://api.codexkey.ru/v1/images/generations \
  -H "Authorization: Bearer sk_cdx_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-image-2", "prompt": "a red apple on a white table", "resolution": "1K", "size": "1024x1024"}'

Ссылка на готовую картинку приходит в data[].url. Она временная, так что файл лучше сразу сохранить.

Параметры

Параметр	Что задаёт
`model`	ID картиночной модели, например gpt-image-2.
`prompt`	Описание картинки.
`resolution`	Разрешение, например 1K, 2K или 4K. От него зависит цена. Допустимые значения указаны на странице модели.
`size`	Размер картинки, например 1024x1024.
`tier`	Относится только к Nano Banana 2: значение lite включает облегчённый режим.

Редактирование по референсу

Редактирование по референсу идёт через POST /v1/images/edits.

Облегчённый режим Nano Banana 2

Nano Banana 2 умеет работать в облегчённом режиме tier: "lite". Параметр resolution при этом не нужен:

bash

curl https://api.codexkey.ru/v1/images/generations \
  -H "Authorization: Bearer sk_cdx_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "nano-banana-2", "prompt": "a red apple on a white table", "tier": "lite"}'

Cheap и Premium

GPT Image 2 (1K, 2K), GPT Image 2.5 и Nano Banana Pro есть и в канале Cheap: там заметно дешевле, но генерация чаще может не получиться. Канал определяется режимом маршрутизации ключа (см. Каналы Premium и Cheap).

Режим ключа	Картинка
`premium`	Premium.
`cheap`	Cheap. Если сейчас не получается, вернётся ошибка 503 model_unavailable, деньги не спишутся.
`auto_cheap, max`	Сначала Cheap, при неудаче Premium.
`auto_premium`	Сначала Premium, при неудаче Cheap.

Платите по тому каналу, который создал картинку; он указан в поле channel ответа (premium или cheap). Варианты, которых нет в Cheap (например, GPT Image 2 в 4K), и модели без Cheap (видео, Nano Banana 2) всегда идут через Premium, даже если у ключа режим cheap.

Цены Cheap указаны в каталоге Cheap.

Видео

Видео создаётся как задача; формат совместим с OpenAI Videos API.

Метод	Путь	Что делает
POST	`/v1/videos`	Создаёт задачу.
GET	`/v1/videos/{id}`	Показывает статус задачи.
GET	`/v1/videos/{id}/content`	Отдаёт готовый файл.

Создайте задачу, проверяйте её статус по идентификатору из поля id ответа и, когда видео будет готово, скачайте файл:

bash

curl https://api.codexkey.ru/v1/videos \
  -H "Authorization: Bearer sk_cdx_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "veo-3.1", "prompt": "a paper boat on a rainy street"}'

curl https://api.codexkey.ru/v1/videos/VIDEO_ID \
  -H "Authorization: Bearer sk_cdx_YOUR_KEY"

curl https://api.codexkey.ru/v1/videos/VIDEO_ID/content \
  -H "Authorization: Bearer sk_cdx_YOUR_KEY" \
  -o video.mp4

Оплата

Списание идёт только за успешный результат. Ошибки и их коды перечислены в справочнике ошибок.

НазадСтриминг ДалееОшибки

API картинок и видео

Генерация картинки

Запрос к POST /v1/images/generations:

bash

curl https://api.codexkey.ru/v1/images/generations \
  -H "Authorization: Bearer sk_cdx_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-image-2", "prompt": "a red apple on a white table", "resolution": "1K", "size": "1024x1024"}'

Ссылка на готовую картинку приходит в data[].url. Она временная, так что файл лучше сразу сохранить.

Параметры

Параметр	Что задаёт
`model`	ID картиночной модели, например gpt-image-2.
`prompt`	Описание картинки.
`resolution`	Разрешение, например 1K, 2K или 4K. От него зависит цена. Допустимые значения указаны на странице модели.
`size`	Размер картинки, например 1024x1024.
`tier`	Относится только к Nano Banana 2: значение lite включает облегчённый режим.

Редактирование по референсу

Редактирование по референсу идёт через POST /v1/images/edits.

Облегчённый режим Nano Banana 2

Nano Banana 2 умеет работать в облегчённом режиме tier: "lite". Параметр resolution при этом не нужен:

bash

curl https://api.codexkey.ru/v1/images/generations \
  -H "Authorization: Bearer sk_cdx_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "nano-banana-2", "prompt": "a red apple on a white table", "tier": "lite"}'

Cheap и Premium

Режим ключа	Картинка
`premium`	Premium.
`cheap`	Cheap. Если сейчас не получается, вернётся ошибка 503 model_unavailable, деньги не спишутся.
`auto_cheap, max`	Сначала Cheap, при неудаче Premium.
`auto_premium`	Сначала Premium, при неудаче Cheap.

Цены Cheap указаны в каталоге Cheap.

Видео

Видео создаётся как задача; формат совместим с OpenAI Videos API.

Метод	Путь	Что делает
POST	`/v1/videos`	Создаёт задачу.
GET	`/v1/videos/{id}`	Показывает статус задачи.
GET	`/v1/videos/{id}/content`	Отдаёт готовый файл.

bash

curl https://api.codexkey.ru/v1/videos \
  -H "Authorization: Bearer sk_cdx_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "veo-3.1", "prompt": "a paper boat on a rainy street"}'

curl https://api.codexkey.ru/v1/videos/VIDEO_ID \
  -H "Authorization: Bearer sk_cdx_YOUR_KEY"

curl https://api.codexkey.ru/v1/videos/VIDEO_ID/content \
  -H "Authorization: Bearer sk_cdx_YOUR_KEY" \
  -o video.mp4

Оплата

Списание идёт только за успешный результат. Ошибки и их коды перечислены в справочнике ошибок.

НазадСтриминг ДалееОшибки