# Seedance 2.0 API Полный справочник API моделей генерации видео Seedance 2.0 от ByteDance. ## Варианты моделей Этот API поддерживает шесть вариантов моделей: | Модель | ID | Описание | |-------|-----|-------------| | **Seedance 2.0 Text to Video** | `seedance-v2.0-text-to-video` | Высококачественная генерация видео по тексту | | **Seedance 2.0 Image to Video** | `seedance-v2.0-image-to-video` | Анимация изображений с управлением движением | | **Seedance 2.0 Reference to Video** | `seedance-v2.0-reference-to-video` | Генерация видео с использованием референсного видео | | **Seedance 2.0 Fast Text to Video** | `seedance-v2.0-fast-text-to-video` | Более быстрая генерация видео по тексту | | **Seedance 2.0 Fast Image to Video** | `seedance-v2.0-fast-image-to-video` | Более быстрая генерация видео по изображению | | **Seedance 2.0 Fast Reference to Video** | `seedance-v2.0-fast-reference-to-video` | Более быстрая генерация видео по референсам | ## Краткое сравнение | Возможность | Стандартные модели | Модели Fast | |---------|-----------------|-------------| | Качество | Более высокое качество | Оптимизированы для скорости | | Время обработки | 3-8 минут | 1-4 минуты | | Диапазон длительности | 4-15 секунд | 4-15 секунд | | Варианты разрешения | 480p, 720p, 1080p, 4k | 480p, 720p | | Референсные материалы | Изображения, видео и аудио для Reference-to-Video | Изображения, видео и аудио для Fast Reference-to-Video | ### Поддерживаемые соотношения сторон `21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` ### Варианты разрешения | Разрешение | Описание | |------------|-------------| | `480p` | Стандартное разрешение, более быстрая обработка | | `720p` | Высокое разрешение, баланс качества и скорости | | `1080p` | Full HD, доступно для всех стандартных моделей Seedance 2.0 | | `4k` | Ultra HD, доступно для всех стандартных моделей Seedance 2.0 | ## Seedance 2.0 Видео по тексту ### Конечная точка ``` POST /api/v1/video/task ``` ### Параметры запроса #### Обязательные | Параметр | Тип | Описание | |-----------|------|-------------| | `model_name` | string | Должно быть `"seedance-v2.0-text-to-video"` | | `prompt` | string | Промпт для генерации видео | | `duration` | integer | Длительность видео в целых секундах (4-15), с шагом 1 | | `resolution` | string | Выходное разрешение: `"480p"`, `"720p"`, `"1080p"` или `"4k"` | | `aspect_ratio` | string | Соотношение сторон видео: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` или `"3:4"` | #### Необязательные | Параметр | Тип | Описание | |-----------|------|-------------| | `sound` | boolean | Генерировать ли звук. По умолчанию `true`; не влияет на цену | ### Пример запроса ```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 Видео по изображению ### Параметры запроса #### Обязательные | Параметр | Тип | Описание | |-----------|------|-------------| | `model_name` | string | Должно быть `"seedance-v2.0-image-to-video"` | | `prompt` | string | Промпт для генерации видео | | `duration` | integer | Длительность видео в целых секундах (4-15), с шагом 1 | | `resolution` | string | Выходное разрешение: `"480p"`, `"720p"`, `"1080p"` или `"4k"` | | `aspect_ratio` | string | Соотношение сторон видео: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` или `"3:4"` | | `image_url` | string | Первый кадр видео | #### Необязательные | Параметр | Тип | Описание | |-----------|------|-------------| | `image_end_url` | string | Необязательный URL изображения последнего кадра | | `sound` | boolean | Генерировать ли звук. По умолчанию `true`; не влияет на цену | ### Пример запроса ```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 Видео по референсам ### Параметры запроса #### Обязательные | Параметр | Тип | Описание | |-----------|------|-------------| | `model_name` | string | Должно быть `"seedance-v2.0-reference-to-video"` | | `prompt` | string | Промпт для генерации видео. Напишите обычный промпт без плейсхолдеров или используйте функцию ссылок @ (AT) с `<<>>`, `<<>>` и `<<>>` для явных ссылок на элементы соответствующих массивов материалов | | `duration` | integer | Длительность видео в целых секундах (4-15), с шагом 1 | | `resolution` | string | Выходное разрешение: `"480p"`, `"720p"`, `"1080p"` или `"4k"` | | `aspect_ratio` | string | Соотношение сторон видео: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` или `"3:4"` | #### Референсные материалы Передайте 1-9 изображений. Изображения можно не передавать только при наличии хотя бы одного референсного видео. | Параметр | Тип | Описание | |-----------|------|-------------| | `images` | string[] | 1-9 URL референсных изображений или пустой массив, если `videos` не пуст | | `videos` | string[] | До 3 URL референсных видео; длительность каждого — 2-15 секунд, общая длительность — не более 15 секунд | | `audios` | string[] | До 3 URL референсных аудио; длительность каждого — 2-15 секунд, общая — не более 15 секунд; WAV или MP3, до 15 MB на клип; требуется хотя бы одно изображение или видео | #### Плейсхолдеры ссылок @ (AT) Функция ссылок @ (AT) связывает референсные материалы с промптом через нумерованные плейсхолдеры `<<<...>>>`. Нумерация начинается с `1` отдельно для каждого типа материала и следует порядку соответствующего массива: | Плейсхолдер | Значение по ссылке | |-------------|------------------| | `<<>>` | `images[0]` | | `<<>>` | `images[1]` | | `<<>>` | `videos[0]` | | `<<>>` | `audios[0]` | Например, если первое изображение задаёт персонажа, а второе — сцену, используйте в `prompt` `<<>>` для персонажа и `<<>>` для сцены. Каждый плейсхолдер должен указывать на существующий элемент соответствующего массива. #### Необязательные | Параметр | Тип | Описание | |-----------|------|-------------| | `sound` | boolean | Генерировать ли синхронизированный звук. По умолчанию `true` | ### Пример запроса ```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'] } ``` ### Пример запроса видео по референсам с @ (AT) ```javascript { model_name: 'seedance-v2.0-reference-to-video', prompt: 'Place the explorer from <<>> in the environment from <<>>, following the camera movement in <<>> and speaking with the reference voice from <<>>', 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 Варианты Fast отдают приоритет скорости обработки. Все модели Fast поддерживают выходное разрешение только `"480p"` и `"720p"`. В остальном структура запросов Fast Видео по тексту и Fast Видео по изображению совпадает с соответствующими стандартными моделями, а Fast Видео по референсам использует те же ограничения материалов, что и стандартная референсная модель. ### Пример запроса Fast ```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 Видео по референсам с @ (AT) ```javascript { model_name: 'seedance-v2.0-fast-reference-to-video', prompt: 'Have the dancer from <<>> perform the movement from <<>> on the stage in <<>>, using the rhythm from <<>>', 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 Видео по референсам #### Обязательные | Параметр | Тип | Описание | |-----------|------|-------------| | `model_name` | string | Должно быть `"seedance-v2.0-fast-reference-to-video"` | | `prompt` | string | Промпт для генерации видео. Напишите обычный промпт без плейсхолдеров или используйте функцию ссылок @ (AT) с `<<>>`, `<<>>` и `<<>>` для явных ссылок на элементы соответствующих массивов материалов | | `duration` | integer | Длительность видео в целых секундах (4-15), с шагом 1 | | `resolution` | string | Выходное разрешение: `"480p"` или `"720p"` | | `aspect_ratio` | string | Соотношение сторон видео: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` или `"3:4"` | #### Референсные материалы | Параметр | Тип | Описание | |-----------|------|-------------| | `images` | string[] | 1-9 URL референсных изображений или пустой массив, если `videos` не пуст | | `videos` | string[] | До 3 URL референсных видео; длительность каждого — 2-15 секунд, общая длительность — не более 15 секунд | | `audios` | string[] | До 3 URL референсных аудио; длительность каждого — 2-15 секунд, общая — не более 15 секунд; WAV или MP3, до 15 MB на клип; требуется хотя бы одно изображение или видео | Описанная выше нумерация плейсхолдеров с 1 также применяется к модели Fast Видео по референсам. #### Необязательные | Параметр | Тип | Описание | |-----------|------|-------------| | `sound` | boolean | Генерировать ли синхронизированный звук. По умолчанию `true` | ## Ограничения материалов Эти ограничения применяются к изображениям первого и последнего кадров и референсным материалам моделей на этой странице. | Материал | Форматы | Ограничения | |-------|---------|--------| | Изображения | JPEG, PNG, WEBP, BMP, TIFF, GIF, HEIC, HEIF | Каждое изображение меньше 30 MB; ширина и высота — по 300-6000 px; отношение ширины к высоте — 0.4-2.5 | | Видео | MP4, MOV | До 200 MB каждое; ширина и высота — по 300-6000 px; отношение ширины к высоте — 0.4-2.5; частота кадров — 24-60 FPS | | Аудио | WAV, MP3 | До 15 MB каждое | | Тело запроса | — | До 64 MB | Для референсных аудио и видео действует отдельное ограничение общей длительности — по 15 секунд. Количество материалов независимо: до 9 изображений, 3 видео и 3 аудиоклипов. Добавление видео не уменьшает допустимое количество изображений. Все модели используют `720p` по умолчанию, но `resolution` всё равно обязателен. Переключатель звука по умолчанию равен `true`; ни он, ни референсное аудио не влияют на цену. Для видео по референсам требуется хотя бы одно изображение или видео; запросы только с аудио не поддерживаются. Загрузка референсных видео удваивает стоимость генерации независимо от их количества или длительности. ## Формат ответа ### Начальный ответ Все модели возвращают `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": { "credit": 0.2, "videos": [ { "url": "https://example.com/generated-video.mp4" } ] } } } ``` ### Значения статуса - `submitted`: задача принята и ожидает обработки - `processing`: выполняется генерация видео - `succeed`: генерация видео завершена - `failed`: генерация видео не удалась ## Время обработки **Стандартные модели**: 3-8 минут в зависимости от длительности и разрешения. **Модели Fast**: 1-4 минуты для большинства конфигураций. Проверяйте статус каждые 5-10 секунд. ## Рекомендации 1. **Выбирайте подходящий вариант**: используйте модели Fast для итераций, стандартные модели — для итогового результата 2. **Чётко описывайте движение**: включайте в промпты конкретные описания движений 3. **Выбор разрешения**: все стандартные модели Seedance 2.0 поддерживают `480p`, `720p`, `1080p` и `4k`; все модели Fast — только `480p` и `720p` 4. **Порядок референсов**: упорядочивайте `images`, `videos` и `audios` осознанно и последовательно ссылайтесь на них в промпте 5. **Запросы только с видео**: используйте пустой массив `images` только при наличии хотя бы одного референсного видео 6. **Длительность материалов**: каждый референсный аудио- и видеоклип должен длиться от 2 до 15 секунд 7. **Использование звука**: пропустите `sound`, чтобы использовать значение по умолчанию `true`, или задайте `false`, чтобы отключить генерацию звука