Картинки и видео
Картиночные модели (GPT Image, Nano Banana) оплачиваются за картинку, цена зависит от параметров. Цены и параметры каждой модели смотрите на её странице в каталоге.
Генерация картинки
Запрос к POST /v1/images/generations:
curl https://api.claudexia.tech/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 для него не нужен:
curl https://api.claudexia.tech/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 ответа и скачайте файл, когда видео будет готово:
curl https://api.claudexia.tech/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.claudexia.tech/v1/videos/VIDEO_ID \
-H "Authorization: Bearer sk_cdx_YOUR_KEY"
curl https://api.claudexia.tech/v1/videos/VIDEO_ID/content \
-H "Authorization: Bearer sk_cdx_YOUR_KEY" \
-o video.mp4Оплата
Деньги списываются только за успешный результат. Список ошибок и коды: справочник ошибок.