Creative APIDocs
Модели

Модели

Все модели

Модели генерации изображений, видео и музыки работают через одну точку — задачи. Меняются только model и input: параметры каждой модели — на её странице. Чат-модели подключаются через SDK OpenAI.

Создание задачи

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

ПолеОбязательноеЧто это
modelдаИдентификатор модели из списка ниже, например seedream/5-pro-text-to-image
inputдаПараметры модели: состав и допустимые значения — на странице модели. Неизвестные поля отклоняются, чтобы опечатка не стала молча проигнорированной настройкой
callBackUrlнетПубличный адрес http(s) до 2048 символов: туда придёт результат (Callback и проверка подписи)
maxPriceнетПредел цены в рублях. Если задача стоит дороже, она не создаётся (code 422)
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": "kling-3.0/video",
  "callBackUrl": "https://example.com/hooks/creative-api",
  "input": {
    "prompt": "A paper boat drifting down a rainy street, cinematic",
    "duration": "5",
    "aspect_ratio": "16:9",
    "mode": "std",
    "sound": false,
    "multi_shots": false
  }
}'
Ответ
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "3f9c2a7be41d4c0c9a7d5e2b1c8f0a64",
    "recordId": "3f9c2a7be41d4c0c9a7d5e2b1c8f0a64"
  }
}

taskId и recordId совпадают. По taskId читается Статус задачи.

Деньги

  1. При создании задачи её цена (у моделей с оплатой по расходу — верхняя граница) резервируется: доступный баланс уменьшается сразу.
  2. После успешной генерации списывается цена, резерв закрывается. У моделей с оплатой по расходу — фактическая сумма, но не больше резерва.
  3. Если генерация не удалась, резерв возвращается полностью.

Если на балансе не хватает денег, задача не создаётся: code 402 и сумма, которой не хватило.

Повтор без двойной оплаты

Передайте заголовок Idempotency-Key (1–255 символов, например UUID). Повтор с тем же ключом и тем же телом вернёт тот же taskId и не создаст вторую задачу. Тот же ключ с другим телом — ошибка 422. Ключ помнится не меньше 7 дней.

Модели

Изображения

МодельmodelЦена
GPT Image 2.6 Sunburst · Text to Imagegpt-image-2-6/sunburst-text-to-imageрезерв от 4,03 ₽
Seedream 5.0 Pro · Text to Imageseedream/5-pro-text-to-imageот 5,25 ₽

Видео

МодельmodelЦена
Kling 3.0 · Videokling-3.0/videoот 11,33 ₽ за секунду

Музыка и аудио

Скоро.

Чат-модели

МодельmodelЦена
GPT-6.1 Solgpt-6-1-solот 4,50 ₽ за 1 млн токенов