API Seedance 2.0

Полный справочник API для моделей генерации Seedance 2.0 video от ByteDance.

Варианты модели

Этот API поддерживает шесть вариантов модели:

Краткое сравнение

Поддерживаемые соотношения сторон

21:9, 16:9, 9:16, 1:1, 4:3, 3:4

Варианты разрешения

Seedance 2.0 text-to-video

Эндпоинт {#}

POST /api/v1/video/task

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

Обязательные

Необязательные

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

javascriptКопировать
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'seedance-v2.0-text-to-video',
    prompt: 'A golden retriever running through a sunlit meadow',
    duration: 6,
    resolution: '720p',
    aspect_ratio: '16:9'
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Seedance 2.0 image-to-video

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

Обязательные

Необязательные

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

javascriptКопировать
{
  model_name: 'seedance-v2.0-image-to-video',
  image_url: 'https://example.com/image.jpg',
  image_end_url: 'https://example.com/end-frame.jpg',
  prompt: 'Camera slowly pulls back to reveal the full landscape',
  duration: 6,
  resolution: '720p',
  aspect_ratio: '16:9'
}

Seedance 2.0 reference-to-video

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

Обязательные

Референсные медиа

Отправьте от 1 до 9 изображений. Изображения можно не указывать, только если предоставлено хотя бы одно референсное видео.

Заполнители ссылок @ (AT)

Функция ссылок @ (AT) связывает референсные медиа с промптом с помощью нумерованных заполнителей <<<...>>>. Нумерация для каждого типа медиа начинается независимо с 1 и соответствует порядку элементов в массиве:

Например, если первое изображение является референсом персонажа, а второе — референсом сцены, используйте в prompt <<<image_1>>> для персонажа и <<<image_2>>> для сцены. Каждый заполнитель должен указывать на существующий элемент соответствующего массива.

Необязательные

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

javascriptКопировать
{
  model_name: 'seedance-v2.0-reference-to-video',
  prompt: 'Use image one for the subject, video one for the movement, and audio one for the atmosphere',
  duration: 8,
  resolution: '1080p',
  aspect_ratio: '16:9',
  sound: true,
  images: ['https://example.com/subject-reference.jpg'],
  videos: ['https://example.com/motion-reference.mp4'],
  audios: ['https://example.com/atmosphere-reference.mp3']
}

Пример запроса Reference-to-Video с @ (AT)

javascriptКопировать
{
  model_name: 'seedance-v2.0-reference-to-video',
  prompt: 'Place the explorer from <<<image_1>>> in the environment from <<<image_2>>>, following the camera movement in <<<video_1>>> and speaking with the reference voice from <<<audio_1>>>',
  duration: 8,
  resolution: '1080p',
  aspect_ratio: '16:9',
  sound: true,
  images: [
    'https://example.com/explorer-reference.jpg',
    'https://example.com/environment-reference.jpg'
  ],
  videos: ['https://example.com/camera-movement-reference.mp4'],
  audios: ['https://example.com/voice-reference.mp3']
}

Быстрые варианты

Быстрые варианты отдают приоритет скорости обработки. Все модели Fast поддерживают только разрешения "480p" и "720p". В остальном Fast Text-to-Video и Fast Image-to-Video используют формы запросов соответствующих стандартных моделей, а Fast Reference-to-Video — те же ограничения референсных медиа, что и стандартная модель.

Пример быстрого запроса

javascriptКопировать
{
  model_name: 'seedance-v2.0-fast-reference-to-video',
  prompt: 'Use image one for the subject, follow the movement from video one, and use audio one for the atmosphere',
  duration: 8,
  resolution: '720p',
  aspect_ratio: '9:16',
  sound: true,
  images: ['https://example.com/subject-reference.jpg'],
  videos: ['https://example.com/motion-reference.mp4'],
  audios: ['https://example.com/atmosphere-reference.mp3']
}

Пример запроса Fast Reference-to-Video с @ (AT)

javascriptКопировать
{
  model_name: 'seedance-v2.0-fast-reference-to-video',
  prompt: 'Have the dancer from <<<image_1>>> perform the movement from <<<video_1>>> on the stage in <<<image_2>>>, using the rhythm from <<<audio_1>>>',
  duration: 8,
  resolution: '720p',
  aspect_ratio: '9:16',
  sound: true,
  images: [
    'https://example.com/dancer-reference.jpg',
    'https://example.com/stage-reference.jpg'
  ],
  videos: ['https://example.com/dance-movement-reference.mp4'],
  audios: ['https://example.com/rhythm-reference.mp3']
}

Параметры Seedance 2.0 Fast Reference-to-Video

Обязательные

Референсные медиа

Описанное выше правило нумерации заполнителей с 1 также применяется к модели Fast Reference-to-Video.

Необязательные

Формат ответа

Начальный ответ

Все модели возвращают task_id для опроса:

jsonКопировать
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}

Ответ опроса

Выполните опрос GET /api/v1/video/{taskId}, чтобы проверить статус:

jsonКопировать
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "task_result": {
      "videos": [
        {
          "url": "https://example.com/generated-video.mp4"
        }
      ]
    }
  }
}

Значения статуса

• submitted: задача принята и ожидает обработки
• processing: генерация видео выполняется
• succeed: генерация видео завершена
• failed: генерация видео завершилась ошибкой

Время обработки

Модели Standard: 3-8 минут в зависимости от длительности и разрешения.

Модели Fast: 1-4 минуты для большинства конфигураций.

Опрашивайте каждые 5-10 секунд, чтобы проверить статус.

Рекомендации

1. Выбирайте правильный вариант: используйте быстрые модели для итераций, стандартные — для финального вывода
2. Четко описывайте движение: Добавляйте движение объекта, движение камеры и развитие сцены, чтобы улучшить динамику видео.
3. Выбор разрешения: Используйте 480p для более быстрой обработки, 720p — для текущего максимального доступного качества
4. Управление камерой: задавайте camera_fixed: true, когда нужны статичные ракурсы камеры
5. Референсные видео: для reference-to-video используйте четкое качественное референсное видео, когда хотите направлять движение или стиль
6. Воспроизводимость: используйте параметр seed, чтобы воспроизводить конкретные генерации
7. Улучшение аудио: включайте sound для более иммерсивного видео