Перейти к основному содержанию
POST
/
v1
/
video
/
generations
curl --request POST \
  --url https://toapis.com/v1/video/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2",
    "prompt": "Спокойный рассвет над океаном, мягкие волны и кинематографичный свет.",
    "duration": 10,
    "ratio": "16:9"
  }'

{
  "id": "tsk_vid_xxx",
  "object": "generation.task",
  "model": "seedance-2",
  "status": "in_progress",
  "progress": 50,
  "created_at": 1778569600,
  "metadata": {}
}

Documentation Index

Fetch the complete documentation index at: https://docs.toapis.com/llms.txt

Use this file to discover all available pages before exploring further.

  • Поддерживаются seedance-2 и seedance-2-fast
  • Поддерживается text-to-video
  • Поддерживается генерация по первому кадру через image_urls
  • Асинхронный процесс с проверкой статуса по ID задачи

​
Authorizations

​
Authorization
string
обязательно
Все запросы требуют Bearer Token аутентификацию.
Authorization: Bearer YOUR_API_KEY

​
Тело запроса

​
model
string
по умолчанию:"seedance-2"
обязательно
Название модели генерации видео.Доступные модели:
  • seedance-2 - стандартная версия
  • seedance-2-fast - быстрая версия
​
prompt
string
обязательно
Текстовый prompt для видео. Рекомендуется явно описывать объект, действие, движение камеры и стиль.
​
duration
integer
по умолчанию:5
Длительность видео в секундах.Поддерживаемый диапазон: 4 до 15 секунд.
​
ratio
string
Соотношение сторон видео.Варианты:
  • 16:9
  • 9:16
  • 1:1
  • 4:3
Рекомендуется явно передавать ratio.
​
image_urls
string[]
Массив URL изображений первого кадра для image-to-video.Используется только первое изображение.Требования к изображениям:
  • Формат: JPEG, JPG, PNG, WEBP
  • Размер файла: до 10MB

​
Использование загруженных материалов

Если вы уже загрузили приватные материалы через API материалов и получили asset_id, в запросе на генерацию не нужно повторно передавать исходный URL файла. Используйте:
  • asset://<ASSET_ID>
Это подходит для:
  • приватных материалов виртуального аватара
  • приватных материалов реального аватара
  • изображений, видео и аудио, которые уже обработаны и находятся в статусе active
Перед использованием загруженного материала в генерации видео выполните такой порядок:
  1. Сначала создайте группу материалов или завершите верификацию реального человека
  2. Загрузите материал и получите asset_id
  3. Проверяйте статус материала, пока он не станет active
  4. Используйте asset://<ASSET_ID> в запросе на генерацию
Для загрузки материалов можно использовать эти руководства:

​
Как использовать материалы в запросах генерации

Материалы-изображения можно использовать как:
  • first_frame
  • last_frame
  • reference_image
Видеоматериалы можно использовать как:
  • reference_video
Аудиоматериалы можно использовать как:
  • reference_audio
Минимальный пример: 
{
  "model": "seedance-2",
  "prompt": "Сохрани персонажа с изображения 1 и покажи, как он медленно поворачивается у панорамного окна, с мягким движением камеры вперед.",
  "image_with_roles": [
    {
      "url": "asset://asset_img_01KXXXXXXX",
      "role": "reference_image"
    }
  ]
}
Пример с видео- и аудиореференсами: 
{
  "model": "seedance-2",
  "prompt": "Сохрани образ персонажа с изображения 1, используй движение камеры из видео 1 и ритм с атмосферой из аудио 1 для генерации разговорного видео в помещении.",
  "image_with_roles": [
    {
      "url": "asset://asset_img_01KXXXXXXX",
      "role": "reference_image"
    }
  ],
  "video_with_roles": [
    {
      "url": "asset://asset_vid_01KXXXXXXX",
      "role": "reference_video"
    }
  ],
  "audio_with_roles": [
    {
      "url": "asset://asset_aud_01KXXXXXXX",
      "role": "reference_audio"
    }
  ]
}
Для генерации видео можно использовать только материалы со статусом active.Если передать asset://<ASSET_ID>, пока материал еще находится в статусе processing или уже перешел в failed, запрос на генерацию может завершиться ошибкой или дать плохой результат.

​
Response

​
id
string
Уникальный ID задачи для проверки статуса.
​
object
string
Тип объекта, всегда generation.task.
​
model
string
Название использованной модели.
​
status
string
Статус задачи.
  • queued
  • in_progress
  • completed
  • failed
​
progress
integer
Прогресс задачи в процентах (0 до 100).
​
created_at
integer
Время создания задачи (Unix timestamp).
​
metadata
object
Метаданные задачи.
curl --request POST \
  --url https://toapis.com/v1/video/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2",
    "prompt": "Спокойный рассвет над океаном, мягкие волны и кинематографичный свет.",
    "duration": 10,
    "ratio": "16:9"
  }'

{
  "id": "tsk_vid_xxx",
  "object": "generation.task",
  "model": "seedance-2",
  "status": "in_progress",
  "progress": 50,
  "created_at": 1778569600,
  "metadata": {}
}

​
Проверка задачи

После отправки запроса вы получите task ID. Проверка статуса и результата: 
curl --request GET \
  --url https://toapis.com/v1/video/generations/{task_id} \
  --header 'Authorization: Bearer YOUR_API_KEY'