Видео API Seedance – Документация Modelflare

Генерация видео Seedance работает через асинхронный Video API. Сначала отправьте задачу, затем проверяйте её состояние по полученному ID. Этот API отделён от Chat Completions.

Перед началом

Создайте API-ключ Modelflare и используйте https://modelflare.dev/v1 как Base URL. Публичные имена моделей: seedance-2.0 и seedance-2.5.

Доступные сочетания длительности и разрешения могут отличаться между моделями. Перед запросом проверьте страницу Модели и цены. При поддержке используйте 480p, 720p, 1080p или 4k.

Запрос «текст в видео»

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "prompt": "Белый кот бежит по неоновой улице под дождём, кинематографическая съёмка в движении",
    "duration": 4,
    "resolution": "720p"
  }'

Запрос «изображение в видео»

Добавьте в image публично доступный HTTPS URL изображения. Остальные поля совпадают с запросом по тексту.

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "prompt": "Объект медленно поворачивается к камере, а камера приближается",
    "image": "https://example.com/reference.png",
    "duration": 4,
    "resolution": "720p"
  }'

Ответ на отправку

Успешный запрос возвращает публичный ID задачи. id и task_id обозначают одну задачу; сохраните любое значение.

{
  "id": "task_example_123",
  "task_id": "task_example_123",
  "object": "video",
  "model": "seedance-2.5",
  "status": "queued"
}

Проверка состояния

Проверяйте задачу каждые несколько секунд. Состояния ожидания могут быть queued, pending, processing или in_progress. Остановите опрос при completed или failed.

curl https://modelflare.dev/v1/videos/task_example_123 \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Пример завершённого ответа:

{
  "id": "task_example_123",
  "task_id": "task_example_123",
  "object": "video",
  "model": "seedance-2.5",
  "status": "completed",
  "progress": 100,
  "metadata": {
    "url": "https://example.com/generated-video.mp4"
  }
}

Скачивание результата

После завершения скачайте видео через endpoint content:

curl -L https://modelflare.dev/v1/videos/task_example_123/content \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -o seedance.mp4

Основные поля запроса

• model: обязательно; seedance-2.0 или seedance-2.5.
• prompt: обязательное описание видео.
• duration: обязательное целое число секунд; текущий минимум — 4 секунды. Также принимается seconds.
• resolution: обязательное разрешение, поддерживаемое выбранной моделью.
• image: необязательный публичный HTTPS URL изображения; включает режим изображения в видео.

HTTP 400 обычно означает неверные параметры, 401 — неверный ключ, 429 — временное ограничение. Ошибки 5xx можно повторять с увеличением задержки.