Sozdai LogoSozdai AIDocs
Документация/Видео/Текст в изображение

Seedance 2.5· Текст в изображение

Текст в изображение
POSThttps://api.sozdai.ai/v1/media/generations

#Создать задачу

Генерация медиа асинхронна: вы сразу получаете id задачи, без ожидания.

bash
curl https://api.sozdai.ai/v1/media/generations \
  -H "Authorization: Bearer $CORRY_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "model": "seedance-2-5", "prompt": "a paper boat floats across a calm lake", "resolution": "480p", "duration": 5, "aspect_ratio": "16:9" }'
# → { "id": "cmus7q0x9000108l3f5g2abcd", "status": "queued" }

#Параметры запроса

ПараметрТипОбязательныйПо умолч.Описание
promptstringНет—
До 20 480 символов. Укажите промпт или добавьте исходный материал.
resolutionstringНет720p
Значения: 480p, 720p, 1080p
durationnumberНет5
4–30 секунд. При -1 длительность выбирается автоматически. Резервируется сумма за 30 секунд, списание по готовому видео.
aspect_ratiostringНетadaptive
Значения: 1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive
first_frame_urlstringНет—
URL первого кадра. Кадры и референсы используются в разных режимах.
last_frame_urlstringНет—
URL последнего кадра. Требуется первый кадр.
reference_image_urlsstring[]Нет—
До 30 референсных изображений.
reference_video_urlsstring[]Нет—
До трёх видео, суммарно до 30 секунд. Тариф с референс-видео применяется к длительности исходных и готового видео.
reference_audio_urlsstring[]Нет—
До трёх аудиофайлов, суммарно до 30 секунд.
omni_reference_task_typestringНетauto
Для редактирования и продления нужны референс-видео и соотношение adaptive.
Значения: auto, reference, edit, extend
generate_audiobooleanНетtrue
output_formatstringНетmp4
Значения: mp4, mov
return_last_framebooleanНетfalse
Добавить последний кадр в result.urls.
web_searchbooleanНетfalse
nsfw_checkerbooleanНет—
callback_urlstringНет—
Публичный HTTP(S)-адрес для получения результата.

#Получение результата

Генерация асинхронная — submit сразу возвращает id задачи. Опрашивайте этот эндпоинт с этим id каждые несколько секунд, пока status не станет succeeded (готово) или ошибкой (failed / timeout).

GEThttps://api.sozdai.ai/v1/media/generations/{id}
bash
# take the id from the submit response, then poll every ~3s
curl https://api.sozdai.ai/v1/media/generations/cmus7q0x9000108l3f5g2abcd \
  -H "Authorization: Bearer $CORRY_KEY"
# repeat until "status" is "succeeded" (or "failed" / "timeout")

#Пример ответа

При создании

json
{
  "id": "cmus7q0x9000108l3f5g2abcd",
  "status": "queued",
  "type": "video",
  "model": "seedance-2-5"
}

При успехе (после опроса)

json
{
  "id": "cmus7q0x9000108l3f5g2abcd",
  "status": "succeeded",
  "type": "video",
  "model": "seedance-2-5",
  "result": { "urls": ["https://cdn.sozdai.ai/video/1782537315223-b49c0c1b771f.mp4"] },
  "cost": "1.0500",
  "currency": "USD"
}

Поля ответа

ПолеТипОписание
statusstringСтатус задачи: queued / submitted / succeeded / failed / timeout.
typestringТип медиа: image / video / music.
modelstringЗапрошенная модель.
resultobjectПри успехе. result.urls — массив постоянных URL файлов.
errorstringСообщение об ошибке при сбое.
coststringСумма списания за задачу — строка в USD (напр. "0.1200"). См. поле currency.
currencystringВалюта cost — всегда "USD".