Creative APIDocs
GPT Image

Изображения / GPT Image

GPT Image 2.6 Sunburst · Text to Image

model: gpt-image-2-6/sunburst-text-to-image

POST https://api.cr-api.ru/api/v1/jobs/createTask

Изображение по текстовому описанию с точным следованием промпту и надписями. Разрешение 1K, 2K или 4K, шесть уровней качества, прозрачный фон, форматы PNG, JPEG, WebP, анимированный GIF и векторный SVG. Оплата по фактическому расходу: при приёме резервируется верхняя граница, списывается не больше неё.

Примеры результатов и доля успешных задач за 24 часа — на странице модели.

Цена

Резерв при приёме4,03 ₽ – 232,95 ₽

Списывается фактический расход, но не больше резерва. Резерв зависит от параметров запроса.

Пример запроса ниже резервирует 7,11 ₽.

Тело запроса

ПолеТипОбязательноеЧто это
modelstringдаgpt-image-2-6/sunburst-text-to-image
inputobjectдаПараметры модели, таблица ниже
callBackUrlstring (URL)нетАдрес для результата, до 2048 символов
maxPricenumberнетПредел цены в рублях: дороже — задача не создаётся (code 422)

Параметры input

ПараметрТипОбязательныйЗначения
promptstringдадлина 1–32000
aspect_ratiostringнетодно из: "auto", "1:1", "3:2", "2:3", "4:3", "3:4", "5:4", "4:5", "16:9", "9:16", "2:1", "1:2", "21:9", "9:21", "3:1", "1:3"
resolutionstringнетодно из: "1K", "2K", "4K"
qualitystringнетодно из: "low", "medium", "high", "xhigh", "max", "auto"
backgroundstringнетодно из: "transparent", "opaque", "auto"
output_formatstringнетодно из: "png", "jpeg", "jpg", "webp", "gif", "svg"
complexitystringнетодно из: "low", "medium", "high"
moderationstringнетодно из: "auto", "low"
output_compressionintegerнетот 0 до 100
sizestringнетформат ^(auto|[1-9][0-9]*x[1-9][0-9]*)$
frame_countintegerнетот 2 до 16
frame_duration_msintegerнетот 20 до 2000; кратно 10
svgobjectнет—

Пример запроса

curl -X POST "https://api.cr-api.ru/api/v1/jobs/createTask" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-image-2-6/sunburst-text-to-image",
  "input": {
    "prompt": "A minimalist poster with the word HELLO in bold letters, lime on black",
    "aspect_ratio": "3:4",
    "resolution": "1K",
    "quality": "medium"
  }
}'

Ответ

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "3f9c2a7be41d4c0c9a7d5e2b1c8f0a64",
    "recordId": "3f9c2a7be41d4c0c9a7d5e2b1c8f0a64"
  }
}

Сумма задачи резервируется сразу. Если генерация не удалась, резерв возвращается. Повтор с заголовком Idempotency-Key не создаст вторую задачу (Все модели).

Результат

Статус и ссылки на файлы — Статус задачи. Ссылки — в resultJson.resultUrls, файлы хранятся 14 дней.

curl "https://api.cr-api.ru/api/v1/jobs/recordInfo?taskId=YOUR_TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"
Задача выполнена
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "3f9c2a7be41d4c0c9a7d5e2b1c8f0a64",
    "model": "gpt-image-2-6/sunburst-text-to-image",
    "state": "success",
    "param": "{\"input\":\"{\\\"prompt\\\":\\\"A minimalist poster with the word HELLO in bold letters, lime on black\\\",\\\"aspect_ratio\\\":\\\"3:4\\\",\\\"resolution\\\":\\\"1K\\\",\\\"quality\\\":\\\"medium\\\"}\",\"model\":\"gpt-image-2-6/sunburst-text-to-image\"}",
    "resultJson": "{\"resultUrls\":[\"https://files.cr-api.ru/Qm3xV8rTt1ZbW0kq7Lr2aA.png\"]}",
    "failCode": null,
    "failMsg": null,
    "costTime": 14,
    "completeTime": 1762941614000,
    "createTime": 1762941600000,
    "updateTime": 1762941614000,
    "creditsConsumed": 7.11
  }
}

Callback

Если в запросе был callBackUrl, после завершения на него придёт POST с тем же объектом. Доставка и подпись — Callback и проверка подписи.

Тело callback
{
  "code": 200,
  "msg": "Task completed successfully.",
  "data": {
    "taskId": "3f9c2a7be41d4c0c9a7d5e2b1c8f0a64",
    "model": "gpt-image-2-6/sunburst-text-to-image",
    "state": "success",
    "param": "{\"input\":\"{\\\"prompt\\\":\\\"A minimalist poster with the word HELLO in bold letters, lime on black\\\",\\\"aspect_ratio\\\":\\\"3:4\\\",\\\"resolution\\\":\\\"1K\\\",\\\"quality\\\":\\\"medium\\\"}\",\"model\":\"gpt-image-2-6/sunburst-text-to-image\"}",
    "resultJson": "{\"resultUrls\":[\"https://files.cr-api.ru/Qm3xV8rTt1ZbW0kq7Lr2aA.png\"]}",
    "failCode": null,
    "failMsg": null,
    "costTime": 14,
    "completeTime": 1762941614000,
    "createTime": 1762941600000,
    "updateTime": 1762941614000,
    "creditsConsumed": 7.11
  }
}