cicora.ai
Русский
Спецификация APIВидео

Видео

Запускайте видео как асинхронную задачу, сохраняйте id задачи и отделяйте создание от чтения результата.

Справочник интеграции: выбирайте параметры и доступные возможности из API-настроек аккаунта и каталога модели для своего окружения.

Создайте задачу

Видео-запрос обычно включает prompt, model и свойства кадра: длительность, соотношение сторон, разрешение или референсы — только когда они поддержаны выбранной моделью.

Сразу сохраните id задачи. Он нужен для отображения прогресса, отмены в вашем интерфейсе и получения итогового контента.

Video generation job
bash
curl --request POST https://cicora.ai/api/v1/videos \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "google/veo-3.1",
    "prompt": "Slow aerial movement above a river at sunrise",
    "duration": 8,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'

Опрос статуса

  • Читайте задачу через GET /videos/{video_id}.
  • Считайте terminal status источником истины о завершении.
  • Используйте нарастающий интервал опроса и прекращайте его при уходе пользователя.

Работа с результатом

После завершения используйте URL или контент, возвращённый задачей, и проверьте готовность файла до показа плеера.

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

Дальше