Creative APIDocs
Модели

Модели

Статус задачи

Детали задачи по taskId: состояние, ссылки на результат, ошибка и списанная сумма. Одна точка для всех моделей, создающих задачи.

GET https://api.cr-api.ru/api/v1/jobs/recordInfo?taskId={taskId}

Запрос

ПараметрГдеОбязательныйЧто это
taskIdqueryдаID из ответа createTask
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": "seedream/5-pro-text-to-image",
    "state": "success",
    "param": "{\"input\":\"{\\\"prompt\\\":\\\"A red fox sitting in fresh snow, morning light, photorealistic\\\",\\\"aspect_ratio\\\":\\\"1:1\\\",\\\"quality\\\":\\\"basic\\\"}\",\"model\":\"seedream/5-pro-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": 5.25
  }
}

Поля data

ПолеЧто это
taskIdID задачи
modelМодель
statewaiting, queuing, generating — в работе; success — готово; fail — ошибка
resultJsonСтрока JSON: {"resultUrls": [...]} — ссылки на файлы результата. Пустая строка, пока задача не готова
failCode, failMsgКод и текст ошибки при fail (Коды ошибок)
paramВаш запрос в виде строки JSON; поле input внутри — тоже строка. Через 60 дней стирается
creditsConsumedСписанная сумма в рублях. Пока задача не завершена — 0: резерв виден в кабинете
costTimeВремя выполнения, секунды
createTime, updateTime, completeTimeВремя в миллисекундах Unix

Чужая или несуществующая задача — code 422 с текстом recordInfo is null.

Как часто спрашивать

Изображения готовы за время от десятков секунд до нескольких минут, видео — за несколько минут. Спрашивайте раз в 3–5 секунд или передайте callBackUrl при создании задачи и не опрашивайте вовсе (Callback и проверка подписи).

Чтение статуса не входит в лимит 20 новых запросов за 10 секунд, но ограничено отдельно — 50 запросов в секунду на аккаунт.