# Seedance 2.5 Flash API Полный справочник по API моделей генерации видео Seedance 2.5 Flash от ByteDance. ## Варианты модели API поддерживает три варианта модели: | Модель | ID | Описание | |-------|----|-------------| | **Seedance 2.5 Flash Text to Video** | `seedance-v2.5-flash-text-to-video` | Генерация высококачественного видео по тексту | | **Seedance 2.5 Flash Image to Video** | `seedance-v2.5-flash-image-to-video` | Генерация видео по первому кадру или по первому и последнему кадрам | | **Seedance 2.5 Flash Reference to Video** | `seedance-v2.5-flash-reference-to-video` | Генерация видео с опорой на исходные изображения, видео и аудио | ## Краткое сравнение | Характеристика | Видео по тексту | Видео по изображению | Видео по референсам | |---------|---------------|----------------|--------------------| | Длительность | 4–30 секунд | 4–30 секунд | 4–30 секунд | | Варианты разрешения | 480p, 720p | 480p, 720p | 480p, 720p | | Соотношение сторон | Необязательно (по умолчанию 16:9) | Не поддерживается | Необязательно (по умолчанию 16:9) | | Обязательные материалы | Нет | Изображение первого кадра | Нет | | Необязательные материалы | Нет | Изображение последнего кадра | Изображения, видео и аудио | ### Поддерживаемые соотношения сторон Для генерации по тексту и по референсам доступны следующие соотношения сторон: `21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` Модель генерации по изображению не поддерживает параметр `aspect_ratio`. ### Варианты разрешения | Разрешение | Описание | |------------|-------------| | `480p` | Стандартная чёткость | | `720p` | Высокая чёткость | ## Seedance 2.5 Flash Text to Video ### Конечная точка ``` POST /api/v1/video/task ``` ### Параметры запроса #### Обязательные | Параметр | Тип | Описание | |-----------|------|-------------| | `model_name` | string | Укажите `"seedance-v2.5-flash-text-to-video"` | | `prompt` | string | Текстовый запрос для генерации видео длиной до 5000 символов | | `resolution` | string | Разрешение выходного видео: `"480p"` или `"720p"`. Значения по умолчанию нет | | `duration` | integer | Длительность видео в целых секундах от 4 до 30 с шагом 1. Значения по умолчанию нет | #### Необязательные | Параметр | Тип | Описание | |-----------|------|-------------| | `aspect_ratio` | string | Соотношение сторон видео: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` или `"3:4"`. По умолчанию `"16:9"` | | `sound` | boolean | Генерировать ли звук. По умолчанию `true`. При значении `false` видео будет без звука | ### Пример запроса ```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.5-flash-text-to-video', prompt: 'A golden retriever running through a sunlit meadow', resolution: '720p', duration: 8, aspect_ratio: '16:9', sound: true }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Seedance 2.5 Flash Image to Video ### Параметры запроса #### Обязательные | Параметр | Тип | Описание | |-----------|------|-------------| | `model_name` | string | Укажите `"seedance-v2.5-flash-image-to-video"` | | `prompt` | string | Текстовый запрос для генерации видео длиной до 5000 символов | | `resolution` | string | Разрешение выходного видео: `"480p"` или `"720p"`. Значения по умолчанию нет | | `duration` | integer | Длительность видео в целых секундах от 4 до 30 с шагом 1. Значения по умолчанию нет | | `image_url` | string | URL изображения первого кадра. См. ограничения для медиафайлов ниже. Выходное видео наследует соотношение сторон изображения | #### Необязательные | Параметр | Тип | Описание | |-----------|------|-------------| | `image_end_url` | string | Необязательный URL изображения последнего кадра. См. ограничения для медиафайлов ниже. Рекомендуется использовать то же соотношение сторон, что и у первого кадра | | `sound` | boolean | Генерировать ли звук. По умолчанию `true`. При значении `false` видео будет без звука | > Не включайте `aspect_ratio` в запросы на генерацию по изображению. Эта модель не поддерживает данный параметр. ### Пример запроса ```javascript { model_name: 'seedance-v2.5-flash-image-to-video', image_url: 'https://example.com/first-frame.jpg', image_end_url: 'https://example.com/last-frame.jpg', prompt: 'Camera slowly pulls back to reveal the full landscape', resolution: '720p', duration: 8, sound: true } ``` ## Seedance 2.5 Flash Reference to Video ### Параметры запроса #### Обязательные | Параметр | Тип | Описание | |-----------|------|-------------| | `model_name` | string | Укажите `"seedance-v2.5-flash-reference-to-video"` | | `prompt` | string | Текстовый запрос для генерации видео длиной до 5000 символов. Можно написать обычный запрос без маркеров или использовать функцию ссылок @ (AT) с маркерами `<<>>`, `<<>>` и `<<>>`, чтобы явно указать элементы соответствующих массивов медиафайлов | | `resolution` | string | Разрешение выходного видео: `"480p"` или `"720p"`. Значения по умолчанию нет | | `duration` | integer | Длительность видео в целых секундах от 4 до 30 с шагом 1. Значения по умолчанию нет | #### Референсные материалы Все референсные материалы необязательны. Можно отправить только изображения, только видео, только аудио или запрос без референсов. Для генерации без референсов рекомендуется модель генерации по тексту. | Параметр | Тип | Описание | |-----------|------|-------------| | `images` | string[] | От 0 до 10 URL референсных изображений. Ссылки на изображения задаются в порядке элементов массива. См. ограничения для медиафайлов ниже | | `videos` | string[] | От 0 до 5 URL референсных видео в формате MP4 или MOV. Длительность каждого видео — от 2 до 30 секунд, суммарная длительность — не более 30 секунд. См. ограничения для медиафайлов ниже. При расчёте стоимости суммарную длительность референсных видео округляют до ближайшей секунды (половину секунды округляют вверх), затем прибавляют к длительности выходного видео | | `audios` | string[] | От 0 до 5 URL референсных аудиофайлов в формате WAV или MP3. Длительность каждого — от 2 до 30 секунд, размер — не более 15 МБ. Суммарная длительность не должна превышать 30 секунд | #### Маркеры ссылок @ (AT) Функция ссылок @ (AT) связывает референсные материалы с текстовым запросом через нумерованные маркеры `<<<...>>>`. Для каждого типа файлов нумерация начинается с `1` и соответствует порядку элементов в его массиве: | Маркер | Элемент массива | |-------------|------------------| | `<<>>` | `images[0]` | | `<<>>` | `images[1]` | | `<<>>` | `videos[0]` | | `<<>>` | `audios[0]` | Например, если первое изображение служит образцом персонажа, а второе — окружения, укажите в `prompt` маркер `<<>>` для персонажа и `<<>>` для окружения. Каждый маркер должен указывать на существующий элемент соответствующего массива. #### Необязательные | Параметр | Тип | Описание | |-----------|------|-------------| | `aspect_ratio` | string | Соотношение сторон видео: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` или `"3:4"`. По умолчанию `"16:9"` | | `sound` | boolean | Генерировать ли звук. По умолчанию `true`. При значении `false` видео будет без звука | ### Пример запроса ```javascript { model_name: 'seedance-v2.5-flash-reference-to-video', prompt: 'Use image one for the subject, video one for the movement, and audio one for the atmosphere', resolution: '720p', duration: 8, 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.5-flash-reference-to-video', prompt: 'Place the explorer from <<>> in the environment from <<>>, following the camera movement in <<>> and speaking with the reference voice from <<>>', resolution: '720p', duration: 10, aspect_ratio: '16:9', sound: true, images: [ 'https://example.com/explorer-reference.jpg', 'https://example.com/environment-reference.png' ], videos: ['https://example.com/camera-movement-reference.mp4'], audios: ['https://example.com/voice-reference.mp3'] } ``` ## Ограничения для медиафайлов Эти ограничения распространяются на изображения первого и последнего кадров и на референсные материалы для моделей, описанных на этой странице. | Материал | Форматы | Ограничения | |-------|---------|--------| | Изображения | JPEG, PNG, WEBP, BMP, TIFF, GIF, HEIC, HEIF | Размер каждого изображения — менее 30 МБ. Ширина и высота — от 300 до 6000 пикселей каждая. Отношение ширины к высоте — от 0,4 до 2,5 | | Видео | MP4, MOV | До 200 МБ на файл. Ширина и высота — от 300 до 6000 пикселей каждая. Отношение ширины к высоте — от 0,4 до 2,5. Частота кадров — от 24 до 60 кадров/с. Общее число пикселей — от 407696 до 8295044 | | Аудио | WAV, MP3 | До 15 МБ на файл | Для референсных аудио и видео действуют отдельные ограничения по суммарной длительности — по 30 секунд на каждый тип. Ограничения по количеству также независимы: до 10 изображений, 5 видео и 5 аудиофрагментов. Для всех моделей обязательны `resolution` и `duration`, значений по умолчанию у них нет. При генерации по тексту и по референсам используется `16:9`, если не задан `aspect_ratio`. По умолчанию звук включён (`true`). Установите `false` для генерации видео без звука. ## Формат ответа ### Первоначальный ответ Все модели возвращают `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`: Не удалось сгенерировать видео ## Время обработки Время обработки зависит от длительности видео, разрешения и текущей очереди. Проверяйте статус каждые 5–10 секунд. ## Рекомендации 1. **Обязательные параметры**: всегда передавайте `prompt`, `resolution` и `duration`. При генерации по тексту и по референсам параметр `aspect_ratio` необязателен. Значение по умолчанию — `16:9` 2. **Соотношение сторон при генерации по изображению**: не передавайте `aspect_ratio` в запросах на генерацию по изображению 3. **Референсные видео**: видео необязательны. Соблюдайте указанные ограничения как для каждого видео, так и для их суммарной длительности 4. **Референсные изображения**: изображения необязательны независимо от наличия видео и аудио. Можно передать до 10 URL изображений поддерживаемых форматов 5. **Референсное аудио**: каждый фрагмент должен длиться от 2 до 30 секунд и занимать не более 15 МБ. Суммарная длительность — не более 30 секунд 6. **Порядок референсов**: расположите элементы `images`, `videos` и `audios` в нужном порядке и учитывайте этот порядок при ссылках на них в текстовом запросе 7. **Звук**: опустите `sound`, чтобы использовать значение по умолчанию `true`, или задайте `false`, чтобы отключить генерацию звука