Creative APIDocs
Seedream

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

Seedream 5.0 Pro · Text to Image

model: seedream/5-pro-text-to-image

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

Изображение по текстовому описанию. Два уровня качества: basic — 1K, high — 2K; восемь соотношений сторон; PNG или JPEG. Цена фиксированная за изображение и зависит только от качества.

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

Цена

quality = basic5,25 ₽
quality = high10,50 ₽

Цена за один результат.

Пример запроса ниже стоит 5,25 ₽.

Тело запроса

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

Параметры input

ПараметрТипОбязательныйЗначения
promptstringдадлина 4–5000
aspect_ratiostringдаодно из: "1:1", "4:3", "3:4", "16:9", "9:16", "2:3", "3:2", "21:9"
qualitystringдаодно из: "basic", "high"
output_formatstringнетодно из: "png", "jpeg"
nsfw_checkerbooleanнет—

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

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": "seedream/5-pro-text-to-image",
  "input": {
    "prompt": "A red fox sitting in fresh snow, morning light, photorealistic",
    "aspect_ratio": "1:1",
    "quality": "basic"
  }
}'

Ответ

{
  "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": "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
  }
}

Callback

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

Тело callback
{
  "code": 200,
  "msg": "Task completed successfully.",
  "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
  }
}