Seedance Video API: модели, поля и требования к материалам
Подключите Seedance с BetterToken API Key и выбирайте поля, материалы и способ генерации по Model ID и операции.
Создавайте видео по тексту, первому кадру или референсам. Четыре модели для Китая поддерживают три операции генерации; две модели SR — генерацию по тексту и одному первому кадру. Выбирайте Model ID по операции, длительности и качеству вывода.
Подготовьте BetterToken API Key. Base URL — https://bettertoken.ai/v1, авторизация — Authorization: Bearer YOUR_API_KEY. Копируйте Model ID точно, с учётом регистра.
Каждый request.json ниже использует общий процесс: расчёт, подтверждение создания, опрос и скачивание. Расчёт не запускает генерацию; создание отправляет платную задачу. Актуальная стоимость — в каталоге моделей.
Модели и операции
Таблица показывает допустимые значения по операциям. Значения по умолчанию, количество материалов и ограничения сочетаний приведены в соответствующих разделах. Размеры материалов указаны из расчёта 1 MB = 1048576 байт.
| Model ID | Операция | Длительность (секунды) | Качество вывода | Пропорции | Аудио | Роли материалов |
|---|---|---|---|---|---|---|
ByteDance-Seedance-2.0-SR | image_to_video | 5–10, шаг 5 | 720p, 1080p, 4k | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | first_frame |
ByteDance-Seedance-2.0-SR | text_to_video | 5–10, шаг 5 | 720p, 1080p, 4k | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | Нет |
ByteDance-Seedance-2.5-SR | image_to_video | 5–10, шаг 5 | 720p, 1080p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | first_frame |
ByteDance-Seedance-2.5-SR | text_to_video | 5–10, шаг 5 | 720p, 1080p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | Нет |
doubao-seedance-2-0-260128 | image_to_video | 4–15, шаг 1; доступно auto | 480p, 720p, 1080p, 4k | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | first_frame, last_frame |
doubao-seedance-2-0-260128 | reference_to_video | 4–15, шаг 1; доступно auto | 480p, 720p, 1080p, 4k | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | reference_image, reference_video, reference_audio |
doubao-seedance-2-0-260128 | text_to_video | 4–15, шаг 1; доступно auto | 480p, 720p, 1080p, 4k | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | Нет |
doubao-seedance-2-0-fast-260128 | image_to_video | 4–15, шаг 1; доступно auto | 480p, 720p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | first_frame, last_frame |
doubao-seedance-2-0-fast-260128 | reference_to_video | 4–15, шаг 1; доступно auto | 480p, 720p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | reference_image, reference_video, reference_audio |
doubao-seedance-2-0-fast-260128 | text_to_video | 4–15, шаг 1; доступно auto | 480p, 720p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | Нет |
doubao-seedance-2-0-mini-260615 | image_to_video | 4–15, шаг 1; доступно auto | 480p, 720p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | first_frame, last_frame |
doubao-seedance-2-0-mini-260615 | reference_to_video | 4–15, шаг 1; доступно auto | 480p, 720p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | reference_image, reference_video, reference_audio |
doubao-seedance-2-0-mini-260615 | text_to_video | 4–15, шаг 1; доступно auto | 480p, 720p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | Нет |
doubao-seedance-2-5-260628 | image_to_video | 4–30, шаг 1; доступно auto | 480p, 720p, 1080p | adaptive | on, off | first_frame, last_frame |
doubao-seedance-2-5-260628 | reference_to_video | 4–30, шаг 1; доступно auto | 480p, 720p, 1080p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | reference_image, reference_video, reference_audio |
doubao-seedance-2-5-260628 | text_to_video | 4–30, шаг 1; доступно auto | 480p, 720p, 1080p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | Нет |
Для фиксированной длительности обе модели SR принимают только 5 или 10 секунд. Модели для Китая и модели SR имеют разные Model ID. Не переносите ограничения полей и материалов одной модели на другую.
Примеры материалов
Примеры генерации по изображению и референсу используют синюю керамическую кружку на белом столе. Оставьте пример изображения для проверки или сначала замените его публичным HTTPS-материалом, который вы вправе использовать и который соответствует ограничениям этой страницы.

Генерация по тексту
ByteDance-Seedance-2.0-SR
Используйте эту операцию, если у вас есть только текстовое описание.
Задайте model равным Model ID этого подраздела, а operation — text_to_video. Используйте только поля генерации из таблицы ниже. Материалы передавайте в массиве media.
| Поле | Тип | Обязательно | Допустимые значения или диапазон | По умолчанию |
|---|---|---|---|---|
audio.mode | string | Нет | on, off | on |
duration.mode | string | Нет | fixed | fixed |
duration.seconds | integer | Нет | 5–10, шаг 5 с; только для фиксированной длительности | 5 |
output.aspect_ratio | string | Нет | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | 16:9 |
output.format | string | Нет | mp4 | mp4 |
output.resolution | string | Нет | 720p, 1080p, 4k | 720p |
prompt | string | Да | строка | Нет |
watermark | boolean | Нет | false | false |
Требования к материалам
Эта операция не принимает материалы.
Ограничения сочетаний
- Для
duration.mode="fixed"требуетсяduration.seconds. При явном указанииfixedтакже задайте число секунд.
Пример запроса
Сохраните JSON ниже в request.json, затем следуйте общему процессу: сначала расчёт, после подтверждения — создание.
{ "model": "ByteDance-Seedance-2.0-SR", "operation": "text_to_video", "prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "16:9" }}Частые ошибки 422
| Код ошибки 422 | Действие |
|---|---|
enum / range / step | Исправьте значения и шаг по таблице полей этого подраздела. |
unsupported_field | Удалите поля, отсутствующие в таблице этой операции. |
requires | Добавьте секунды, пропорции, настройки аудио или материалы по ограничениям сочетаний этого подраздела. |
ByteDance-Seedance-2.5-SR
Используйте эту операцию, если у вас есть только текстовое описание.
Задайте model равным Model ID этого подраздела, а operation — text_to_video. Используйте только поля генерации из таблицы ниже. Материалы передавайте в массиве media.
| Поле | Тип | Обязательно | Допустимые значения или диапазон | По умолчанию |
|---|---|---|---|---|
audio.mode | string | Нет | on, off | on |
duration.mode | string | Нет | fixed | fixed |
duration.seconds | integer | Нет | 5–10, шаг 5 с; только для фиксированной длительности | 5 |
output.aspect_ratio | string | Нет | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | 16:9 |
output.format | string | Нет | mp4 | mp4 |
output.resolution | string | Нет | 720p, 1080p | 720p |
prompt | string | Да | строка | Нет |
watermark | boolean | Нет | false | false |
Требования к материалам
Эта операция не принимает материалы.
Ограничения сочетаний
- Для
duration.mode="fixed"требуетсяduration.seconds. При явном указанииfixedтакже задайте число секунд.
Пример запроса
Сохраните JSON ниже в request.json, затем следуйте общему процессу: сначала расчёт, после подтверждения — создание.
{ "model": "ByteDance-Seedance-2.5-SR", "operation": "text_to_video", "prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "16:9" }}Частые ошибки 422
| Код ошибки 422 | Действие |
|---|---|
enum / range / step | Исправьте значения и шаг по таблице полей этого подраздела. |
unsupported_field | Удалите поля, отсутствующие в таблице этой операции. |
requires | Добавьте секунды, пропорции, настройки аудио или материалы по ограничениям сочетаний этого подраздела. |
doubao-seedance-2-0-260128
Используйте эту операцию, если у вас есть только текстовое описание.
Задайте model равным Model ID этого подраздела, а operation — text_to_video. Используйте только поля генерации из таблицы ниже. Материалы передавайте в массиве media.
| Поле | Тип | Обязательно | Допустимые значения или диапазон | По умолчанию |
|---|---|---|---|---|
audio.mode | string | Нет | on, off | on |
duration.mode | string | Нет | fixed, auto | fixed |
duration.seconds | integer | Нет | 4–15, шаг 1 с; только для фиксированной длительности | Нет |
output.aspect_ratio | string | Нет | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | Нет | mp4 | mp4 |
output.resolution | string | Нет | 480p, 720p, 1080p, 4k | 720p |
prompt | string | Да | строка | Нет |
watermark | boolean | Нет | false, true | false |
Требования к материалам
Эта операция не принимает материалы.
Ограничения сочетаний
- Для
duration.mode="fixed"требуетсяduration.seconds. При явном указанииfixedтакже задайте число секунд. - При
duration.mode="auto"не передавайтеduration.seconds.
Пример запроса
Сохраните JSON ниже в request.json, затем следуйте общему процессу: сначала расчёт, после подтверждения — создание.
{ "model": "doubao-seedance-2-0-260128", "operation": "text_to_video", "prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "16:9" }}Частые ошибки 422
| Код ошибки 422 | Действие |
|---|---|
enum / range / step | Исправьте значения и шаг по таблице полей этого подраздела. |
unsupported_field | Удалите поля, отсутствующие в таблице этой операции. |
requires | Добавьте секунды, пропорции, настройки аудио или материалы по ограничениям сочетаний этого подраздела. |
excludes | Удалите поля, несовместимые с автоматической длительностью или последним кадром. |
doubao-seedance-2-0-fast-260128
Используйте эту операцию, если у вас есть только текстовое описание.
Задайте model равным Model ID этого подраздела, а operation — text_to_video. Используйте только поля генерации из таблицы ниже. Материалы передавайте в массиве media.
| Поле | Тип | Обязательно | Допустимые значения или диапазон | По умолчанию |
|---|---|---|---|---|
audio.mode | string | Нет | on, off | on |
duration.mode | string | Нет | fixed, auto | fixed |
duration.seconds | integer | Нет | 4–15, шаг 1 с; только для фиксированной длительности | Нет |
output.aspect_ratio | string | Нет | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | Нет | mp4 | mp4 |
output.resolution | string | Нет | 480p, 720p | 720p |
prompt | string | Да | строка | Нет |
watermark | boolean | Нет | false, true | false |
Требования к материалам
Эта операция не принимает материалы.
Ограничения сочетаний
- Для
duration.mode="fixed"требуетсяduration.seconds. При явном указанииfixedтакже задайте число секунд. - При
duration.mode="auto"не передавайтеduration.seconds.
Пример запроса
Сохраните JSON ниже в request.json, затем следуйте общему процессу: сначала расчёт, после подтверждения — создание.
{ "model": "doubao-seedance-2-0-fast-260128", "operation": "text_to_video", "prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "16:9" }}Частые ошибки 422
| Код ошибки 422 | Действие |
|---|---|
enum / range / step | Исправьте значения и шаг по таблице полей этого подраздела. |
unsupported_field | Удалите поля, отсутствующие в таблице этой операции. |
requires | Добавьте секунды, пропорции, настройки аудио или материалы по ограничениям сочетаний этого подраздела. |
excludes | Удалите поля, несовместимые с автоматической длительностью или последним кадром. |
doubao-seedance-2-0-mini-260615
Используйте эту операцию, если у вас есть только текстовое описание.
Задайте model равным Model ID этого подраздела, а operation — text_to_video. Используйте только поля генерации из таблицы ниже. Материалы передавайте в массиве media.
| Поле | Тип | Обязательно | Допустимые значения или диапазон | По умолчанию |
|---|---|---|---|---|
audio.mode | string | Нет | on, off | on |
duration.mode | string | Нет | fixed, auto | fixed |
duration.seconds | integer | Нет | 4–15, шаг 1 с; только для фиксированной длительности | Нет |
output.aspect_ratio | string | Нет | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | Нет | mp4 | mp4 |
output.resolution | string | Нет | 480p, 720p | 720p |
prompt | string | Да | строка | Нет |
watermark | boolean | Нет | false, true | false |
Требования к материалам
Эта операция не принимает материалы.
Ограничения сочетаний
- Для
duration.mode="fixed"требуетсяduration.seconds. При явном указанииfixedтакже задайте число секунд. - При
duration.mode="auto"не передавайтеduration.seconds.
Пример запроса
Сохраните JSON ниже в request.json, затем следуйте общему процессу: сначала расчёт, после подтверждения — создание.
{ "model": "doubao-seedance-2-0-mini-260615", "operation": "text_to_video", "prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "16:9" }}Частые ошибки 422
| Код ошибки 422 | Действие |
|---|---|
enum / range / step | Исправьте значения и шаг по таблице полей этого подраздела. |
unsupported_field | Удалите поля, отсутствующие в таблице этой операции. |
requires | Добавьте секунды, пропорции, настройки аудио или материалы по ограничениям сочетаний этого подраздела. |
excludes | Удалите поля, несовместимые с автоматической длительностью или последним кадром. |
doubao-seedance-2-5-260628
Используйте эту операцию, если у вас есть только текстовое описание.
Задайте model равным Model ID этого подраздела, а operation — text_to_video. Используйте только поля генерации из таблицы ниже. Материалы передавайте в массиве media.
| Поле | Тип | Обязательно | Допустимые значения или диапазон | По умолчанию |
|---|---|---|---|---|
audio.mode | string | Нет | on, off | on |
duration.mode | string | Нет | fixed, auto | auto |
duration.seconds | integer | Нет | 4–30, шаг 1 с; только для фиксированной длительности | Нет |
output.aspect_ratio | string | Нет | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | Нет | mp4 | mp4 |
output.resolution | string | Нет | 480p, 720p, 1080p | 720p |
prompt | string | Да | строка | Нет |
watermark | boolean | Нет | false, true | false |
Требования к материалам
Эта операция не принимает материалы.
Ограничения сочетаний
- Для
duration.mode="fixed"требуетсяduration.seconds. При явном указанииfixedтакже задайте число секунд. - При
duration.mode="auto"не передавайтеduration.seconds.
Пример запроса
Сохраните JSON ниже в request.json, затем следуйте общему процессу: сначала расчёт, после подтверждения — создание.
{ "model": "doubao-seedance-2-5-260628", "operation": "text_to_video", "prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "16:9" }}Частые ошибки 422
| Код ошибки 422 | Действие |
|---|---|
enum / range / step | Исправьте значения и шаг по таблице полей этого подраздела. |
unsupported_field | Удалите поля, отсутствующие в таблице этой операции. |
requires | Добавьте секунды, пропорции, настройки аудио или материалы по ограничениям сочетаний этого подраздела. |
excludes | Удалите поля, несовместимые с автоматической длительностью или последним кадром. |
Генерация по изображению
ByteDance-Seedance-2.0-SR
Используйте эту операцию, чтобы задать изображениями первый кадр либо первый и последний кадры.
Задайте model равным Model ID этого подраздела, а operation — image_to_video. Используйте только поля генерации из таблицы ниже. Материалы передавайте в массиве media.
| Поле | Тип | Обязательно | Допустимые значения или диапазон | По умолчанию |
|---|---|---|---|---|
audio.mode | string | Нет | on, off | on |
duration.mode | string | Нет | fixed | fixed |
duration.seconds | integer | Нет | 5–10, шаг 5 с; только для фиксированной длительности | 5 |
output.aspect_ratio | string | Нет | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | 16:9 |
output.format | string | Нет | mp4 | mp4 |
output.resolution | string | Нет | 720p, 1080p, 4k | 720p |
prompt | string | Да | строка | Нет |
watermark | boolean | Нет | false | false |
Требования к материалам
| Роль материала | Тип и количество | Форматы | Ограничения на файл |
|---|---|---|---|
first_frame | image, 1 (обязательно) | jpeg, png, webp | размер не более 10 MB; ширина 128–4096 px; высота 128–4096 px |
Обязательность материалов также определяется ограничениями сочетаний ниже.
Ограничения сочетаний
- Для
duration.mode="fixed"требуетсяduration.seconds. При явном указанииfixedтакже задайте число секунд. - Обязательно передайте
first_frame.
Пример запроса
Сохраните JSON ниже в request.json, затем следуйте общему процессу: сначала расчёт, после подтверждения — создание.
{ "model": "ByteDance-Seedance-2.0-SR", "operation": "image_to_video", "prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "first", "type": "image", "role": "first_frame", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Частые ошибки 422
| Код ошибки 422 | Действие |
|---|---|
enum / range / step | Исправьте значения и шаг по таблице полей этого подраздела. |
unsupported_field | Удалите поля, отсутствующие в таблице этой операции. |
requires | Добавьте секунды, пропорции, настройки аудио или материалы по ограничениям сочетаний этого подраздела. |
count / media_role | Исправьте роли и количество по таблице материалов этого подраздела. |
video_input_unsupported | Проверьте публичный HTTPS-адрес, Content-Type и формат файла, затем повторите расчёт. |
ByteDance-Seedance-2.5-SR
Используйте эту операцию, чтобы задать изображениями первый кадр либо первый и последний кадры.
Задайте model равным Model ID этого подраздела, а operation — image_to_video. Используйте только поля генерации из таблицы ниже. Материалы передавайте в массиве media.
| Поле | Тип | Обязательно | Допустимые значения или диапазон | По умолчанию |
|---|---|---|---|---|
audio.mode | string | Нет | on, off | on |
duration.mode | string | Нет | fixed | fixed |
duration.seconds | integer | Нет | 5–10, шаг 5 с; только для фиксированной длительности | 5 |
output.aspect_ratio | string | Нет | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | 16:9 |
output.format | string | Нет | mp4 | mp4 |
output.resolution | string | Нет | 720p, 1080p | 720p |
prompt | string | Да | строка | Нет |
watermark | boolean | Нет | false | false |
Требования к материалам
| Роль материала | Тип и количество | Форматы | Ограничения на файл |
|---|---|---|---|
first_frame | image, 1 (обязательно) | jpeg, png, webp | размер не более 10 MB; ширина 128–4096 px; высота 128–4096 px |
Обязательность материалов также определяется ограничениями сочетаний ниже.
Ограничения сочетаний
- Для
duration.mode="fixed"требуетсяduration.seconds. При явном указанииfixedтакже задайте число секунд. - Обязательно передайте
first_frame.
Пример запроса
Сохраните JSON ниже в request.json, затем следуйте общему процессу: сначала расчёт, после подтверждения — создание.
{ "model": "ByteDance-Seedance-2.5-SR", "operation": "image_to_video", "prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "first", "type": "image", "role": "first_frame", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Частые ошибки 422
| Код ошибки 422 | Действие |
|---|---|
enum / range / step | Исправьте значения и шаг по таблице полей этого подраздела. |
unsupported_field | Удалите поля, отсутствующие в таблице этой операции. |
requires | Добавьте секунды, пропорции, настройки аудио или материалы по ограничениям сочетаний этого подраздела. |
count / media_role | Исправьте роли и количество по таблице материалов этого подраздела. |
video_input_unsupported | Проверьте публичный HTTPS-адрес, Content-Type и формат файла, затем повторите расчёт. |
doubao-seedance-2-0-260128
Используйте эту операцию, чтобы задать изображениями первый кадр либо первый и последний кадры.
Задайте model равным Model ID этого подраздела, а operation — image_to_video. Используйте только поля генерации из таблицы ниже. Материалы передавайте в массиве media.
| Поле | Тип | Обязательно | Допустимые значения или диапазон | По умолчанию |
|---|---|---|---|---|
audio.mode | string | Нет | on, off | on |
duration.mode | string | Нет | fixed, auto | fixed |
duration.seconds | integer | Нет | 4–15, шаг 1 с; только для фиксированной длительности | Нет |
output.aspect_ratio | string | Нет | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | Нет | mp4 | mp4 |
output.resolution | string | Нет | 480p, 720p, 1080p, 4k | 720p |
prompt | string | Да | строка | Нет |
watermark | boolean | Нет | false, true | false |
Требования к материалам
| Роль материала | Тип и количество | Форматы | Ограничения на файл |
|---|---|---|---|
first_frame | image, 1 (обязательно) | jpeg, png, webp, bmp, tiff, gif, heic, heif | размер 1–31457279 байт; ширина 300–6000 px; высота 300–6000 px |
last_frame | image, необязательно, не более 1 | jpeg, png, webp, bmp, tiff, gif, heic, heif | размер 1–31457279 байт; ширина 300–6000 px; высота 300–6000 px |
Обязательность материалов также определяется ограничениями сочетаний ниже.
Ограничения сочетаний
- Для
duration.mode="fixed"требуетсяduration.seconds. При явном указанииfixedтакже задайте число секунд. - При
duration.mode="auto"не передавайтеduration.seconds. - Обязательно передайте
first_frame.
Пример запроса
Сохраните JSON ниже в request.json, затем следуйте общему процессу: сначала расчёт, после подтверждения — создание.
{ "model": "doubao-seedance-2-0-260128", "operation": "image_to_video", "prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "first", "type": "image", "role": "first_frame", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Частые ошибки 422
| Код ошибки 422 | Действие |
|---|---|
enum / range / step | Исправьте значения и шаг по таблице полей этого подраздела. |
unsupported_field | Удалите поля, отсутствующие в таблице этой операции. |
requires | Добавьте секунды, пропорции, настройки аудио или материалы по ограничениям сочетаний этого подраздела. |
excludes | Удалите поля, несовместимые с автоматической длительностью или последним кадром. |
count / media_role | Исправьте роли и количество по таблице материалов этого подраздела. |
video_input_unsupported | Проверьте публичный HTTPS-адрес, Content-Type и формат файла, затем повторите расчёт. |
doubao-seedance-2-0-fast-260128
Используйте эту операцию, чтобы задать изображениями первый кадр либо первый и последний кадры.
Задайте model равным Model ID этого подраздела, а operation — image_to_video. Используйте только поля генерации из таблицы ниже. Материалы передавайте в массиве media.
| Поле | Тип | Обязательно | Допустимые значения или диапазон | По умолчанию |
|---|---|---|---|---|
audio.mode | string | Нет | on, off | on |
duration.mode | string | Нет | fixed, auto | fixed |
duration.seconds | integer | Нет | 4–15, шаг 1 с; только для фиксированной длительности | Нет |
output.aspect_ratio | string | Нет | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | Нет | mp4 | mp4 |
output.resolution | string | Нет | 480p, 720p | 720p |
prompt | string | Да | строка | Нет |
watermark | boolean | Нет | false, true | false |
Требования к материалам
| Роль материала | Тип и количество | Форматы | Ограничения на файл |
|---|---|---|---|
first_frame | image, 1 (обязательно) | jpeg, png, webp, bmp, tiff, gif, heic, heif | размер 1–31457279 байт; ширина 300–6000 px; высота 300–6000 px |
last_frame | image, необязательно, не более 1 | jpeg, png, webp, bmp, tiff, gif, heic, heif | размер 1–31457279 байт; ширина 300–6000 px; высота 300–6000 px |
Обязательность материалов также определяется ограничениями сочетаний ниже.
Ограничения сочетаний
- Для
duration.mode="fixed"требуетсяduration.seconds. При явном указанииfixedтакже задайте число секунд. - При
duration.mode="auto"не передавайтеduration.seconds. - Обязательно передайте
first_frame.
Пример запроса
Сохраните JSON ниже в request.json, затем следуйте общему процессу: сначала расчёт, после подтверждения — создание.
{ "model": "doubao-seedance-2-0-fast-260128", "operation": "image_to_video", "prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "first", "type": "image", "role": "first_frame", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Частые ошибки 422
| Код ошибки 422 | Действие |
|---|---|
enum / range / step | Исправьте значения и шаг по таблице полей этого подраздела. |
unsupported_field | Удалите поля, отсутствующие в таблице этой операции. |
requires | Добавьте секунды, пропорции, настройки аудио или материалы по ограничениям сочетаний этого подраздела. |
excludes | Удалите поля, несовместимые с автоматической длительностью или последним кадром. |
count / media_role | Исправьте роли и количество по таблице материалов этого подраздела. |
video_input_unsupported | Проверьте публичный HTTPS-адрес, Content-Type и формат файла, затем повторите расчёт. |
doubao-seedance-2-0-mini-260615
Используйте эту операцию, чтобы задать изображениями первый кадр либо первый и последний кадры.
Задайте model равным Model ID этого подраздела, а operation — image_to_video. Используйте только поля генерации из таблицы ниже. Материалы передавайте в массиве media.
| Поле | Тип | Обязательно | Допустимые значения или диапазон | По умолчанию |
|---|---|---|---|---|
audio.mode | string | Нет | on, off | on |
duration.mode | string | Нет | fixed, auto | fixed |
duration.seconds | integer | Нет | 4–15, шаг 1 с; только для фиксированной длительности | Нет |
output.aspect_ratio | string | Нет | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | Нет | mp4 | mp4 |
output.resolution | string | Нет | 480p, 720p | 720p |
prompt | string | Да | строка | Нет |
watermark | boolean | Нет | false, true | false |
Требования к материалам
| Роль материала | Тип и количество | Форматы | Ограничения на файл |
|---|---|---|---|
first_frame | image, 1 (обязательно) | jpeg, png, webp, bmp, tiff, gif, heic, heif | размер 1–31457279 байт; ширина 300–6000 px; высота 300–6000 px |
last_frame | image, необязательно, не более 1 | jpeg, png, webp, bmp, tiff, gif, heic, heif | размер 1–31457279 байт; ширина 300–6000 px; высота 300–6000 px |
Обязательность материалов также определяется ограничениями сочетаний ниже.
Ограничения сочетаний
- Для
duration.mode="fixed"требуетсяduration.seconds. При явном указанииfixedтакже задайте число секунд. - При
duration.mode="auto"не передавайтеduration.seconds. - Обязательно передайте
first_frame.
Пример запроса
Сохраните JSON ниже в request.json, затем следуйте общему процессу: сначала расчёт, после подтверждения — создание.
{ "model": "doubao-seedance-2-0-mini-260615", "operation": "image_to_video", "prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "first", "type": "image", "role": "first_frame", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Частые ошибки 422
| Код ошибки 422 | Действие |
|---|---|
enum / range / step | Исправьте значения и шаг по таблице полей этого подраздела. |
unsupported_field | Удалите поля, отсутствующие в таблице этой операции. |
requires | Добавьте секунды, пропорции, настройки аудио или материалы по ограничениям сочетаний этого подраздела. |
excludes | Удалите поля, несовместимые с автоматической длительностью или последним кадром. |
count / media_role | Исправьте роли и количество по таблице материалов этого подраздела. |
video_input_unsupported | Проверьте публичный HTTPS-адрес, Content-Type и формат файла, затем повторите расчёт. |
doubao-seedance-2-5-260628
Используйте эту операцию, чтобы задать изображениями первый кадр либо первый и последний кадры.
Задайте model равным Model ID этого подраздела, а operation — image_to_video. Используйте только поля генерации из таблицы ниже. Материалы передавайте в массиве media.
| Поле | Тип | Обязательно | Допустимые значения или диапазон | По умолчанию |
|---|---|---|---|---|
audio.mode | string | Нет | on, off | on |
duration.mode | string | Нет | fixed, auto | auto |
duration.seconds | integer | Нет | 4–30, шаг 1 с; только для фиксированной длительности | Нет |
output.aspect_ratio | string | Нет | adaptive | adaptive |
output.format | string | Нет | mp4 | mp4 |
output.resolution | string | Нет | 480p, 720p, 1080p | 720p |
prompt | string | Да | строка | Нет |
watermark | boolean | Нет | false, true | false |
Требования к материалам
| Роль материала | Тип и количество | Форматы | Ограничения на файл |
|---|---|---|---|
first_frame | image, 1 (обязательно) | jpeg, png, webp, bmp, tiff, gif, heic, heif | размер 1–31457279 байт; ширина 300–6000 px; высота 300–6000 px |
last_frame | image, необязательно, не более 1 | jpeg, png, webp, bmp, tiff, gif, heic, heif | размер 1–31457279 байт; ширина 300–6000 px; высота 300–6000 px |
Обязательность материалов также определяется ограничениями сочетаний ниже.
Ограничения сочетаний
- Для
duration.mode="fixed"требуетсяduration.seconds. При явном указанииfixedтакже задайте число секунд. - При
duration.mode="auto"не передавайтеduration.seconds. - Обязательно передайте
first_frame. - Эта операция требует
output.aspect_ratio="adaptive"и для одного первого кадра, и для сочетания первого и последнего кадров.
Пример запроса
Сохраните JSON ниже в request.json, затем следуйте общему процессу: сначала расчёт, после подтверждения — создание.
{ "model": "doubao-seedance-2-5-260628", "operation": "image_to_video", "prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "first", "type": "image", "role": "first_frame", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Частые ошибки 422
| Код ошибки 422 | Действие |
|---|---|
enum / range / step | Исправьте значения и шаг по таблице полей этого подраздела. |
unsupported_field | Удалите поля, отсутствующие в таблице этой операции. |
requires | Добавьте секунды, пропорции, настройки аудио или материалы по ограничениям сочетаний этого подраздела. |
excludes | Удалите поля, несовместимые с автоматической длительностью или последним кадром. |
count / media_role | Исправьте роли и количество по таблице материалов этого подраздела. |
video_input_unsupported | Проверьте публичный HTTPS-адрес, Content-Type и формат файла, затем повторите расчёт. |
Генерация по референсам
doubao-seedance-2-0-260128
Используйте эту операцию, чтобы сохранить особенности объекта или движения из референсов.
Задайте model равным Model ID этого подраздела, а operation — reference_to_video. Используйте только поля генерации из таблицы ниже. Материалы передавайте в массиве media.
| Поле | Тип | Обязательно | Допустимые значения или диапазон | По умолчанию |
|---|---|---|---|---|
audio.mode | string | Нет | on, off | on |
duration.mode | string | Нет | fixed, auto | fixed |
duration.seconds | integer | Нет | 4–15, шаг 1 с; только для фиксированной длительности | Нет |
output.aspect_ratio | string | Нет | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | Нет | mp4 | mp4 |
output.resolution | string | Нет | 480p, 720p, 1080p, 4k | 720p |
prompt | string | Да | строка | Нет |
watermark | boolean | Нет | false, true | false |
Требования к материалам
| Роль материала | Тип и количество | Форматы | Ограничения на файл |
|---|---|---|---|
reference_image | image, необязательно, не более 9 | jpeg, png, webp, bmp, tiff, gif, heic, heif | размер 1–31457279 байт; ширина 300–6000 px; высота 300–6000 px |
reference_video | video, необязательно, не более 3 | mp4, mov | размер не более 200 MB; ширина 300–6000 px; высота 300–6000 px; длительность 2–15 с; частота кадров не ниже 24 fps, и не выше 60 fps; всего для этой роли не более 15 с |
reference_audio | audio, необязательно, не более 3 | wav, mp3 | размер не более 15 MB; длительность 2–15 с; всего для этой роли не более 15 с |
Обязательность материалов также определяется ограничениями сочетаний ниже.
Ограничения сочетаний
- Для
duration.mode="fixed"требуетсяduration.seconds. При явном указанииfixedтакже задайте число секунд. - При
duration.mode="auto"не передавайтеduration.seconds. - Передайте хотя бы одну роль:
reference_image,reference_video,reference_audio. - Референсное аудио нельзя использовать отдельно. Также передайте референсное изображение или видео.
Пример запроса
Сохраните JSON ниже в request.json, затем следуйте общему процессу: сначала расчёт, после подтверждения — создание.
{ "model": "doubao-seedance-2-0-260128", "operation": "reference_to_video", "prompt": "Create a product video of the blue ceramic mug in the reference image. Keep its shape and color.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "reference", "type": "image", "role": "reference_image", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Частые ошибки 422
| Код ошибки 422 | Действие |
|---|---|
enum / range / step | Исправьте значения и шаг по таблице полей этого подраздела. |
unsupported_field | Удалите поля, отсутствующие в таблице этой операции. |
requires | Добавьте секунды, пропорции, настройки аудио или материалы по ограничениям сочетаний этого подраздела. |
excludes | Удалите поля, несовместимые с автоматической длительностью или последним кадром. |
count / media_role | Исправьте роли и количество по таблице материалов этого подраздела. |
video_input_unsupported | Проверьте публичный HTTPS-адрес, Content-Type и формат файла, затем повторите расчёт. |
doubao-seedance-2-0-fast-260128
Используйте эту операцию, чтобы сохранить особенности объекта или движения из референсов.
Задайте model равным Model ID этого подраздела, а operation — reference_to_video. Используйте только поля генерации из таблицы ниже. Материалы передавайте в массиве media.
| Поле | Тип | Обязательно | Допустимые значения или диапазон | По умолчанию |
|---|---|---|---|---|
audio.mode | string | Нет | on, off | on |
duration.mode | string | Нет | fixed, auto | fixed |
duration.seconds | integer | Нет | 4–15, шаг 1 с; только для фиксированной длительности | Нет |
output.aspect_ratio | string | Нет | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | Нет | mp4 | mp4 |
output.resolution | string | Нет | 480p, 720p | 720p |
prompt | string | Да | строка | Нет |
watermark | boolean | Нет | false, true | false |
Требования к материалам
| Роль материала | Тип и количество | Форматы | Ограничения на файл |
|---|---|---|---|
reference_image | image, необязательно, не более 9 | jpeg, png, webp, bmp, tiff, gif, heic, heif | размер 1–31457279 байт; ширина 300–6000 px; высота 300–6000 px |
reference_video | video, необязательно, не более 3 | mp4, mov | размер не более 200 MB; ширина 300–6000 px; высота 300–6000 px; длительность 2–15 с; частота кадров не ниже 24 fps, и не выше 60 fps; всего для этой роли не более 15 с |
reference_audio | audio, необязательно, не более 3 | wav, mp3 | размер не более 15 MB; длительность 2–15 с; всего для этой роли не более 15 с |
Обязательность материалов также определяется ограничениями сочетаний ниже.
Ограничения сочетаний
- Для
duration.mode="fixed"требуетсяduration.seconds. При явном указанииfixedтакже задайте число секунд. - При
duration.mode="auto"не передавайтеduration.seconds. - Передайте хотя бы одну роль:
reference_image,reference_video,reference_audio. - Референсное аудио нельзя использовать отдельно. Также передайте референсное изображение или видео.
Пример запроса
Сохраните JSON ниже в request.json, затем следуйте общему процессу: сначала расчёт, после подтверждения — создание.
{ "model": "doubao-seedance-2-0-fast-260128", "operation": "reference_to_video", "prompt": "Create a product video of the blue ceramic mug in the reference image. Keep its shape and color.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "reference", "type": "image", "role": "reference_image", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Частые ошибки 422
| Код ошибки 422 | Действие |
|---|---|
enum / range / step | Исправьте значения и шаг по таблице полей этого подраздела. |
unsupported_field | Удалите поля, отсутствующие в таблице этой операции. |
requires | Добавьте секунды, пропорции, настройки аудио или материалы по ограничениям сочетаний этого подраздела. |
excludes | Удалите поля, несовместимые с автоматической длительностью или последним кадром. |
count / media_role | Исправьте роли и количество по таблице материалов этого подраздела. |
video_input_unsupported | Проверьте публичный HTTPS-адрес, Content-Type и формат файла, затем повторите расчёт. |
doubao-seedance-2-0-mini-260615
Используйте эту операцию, чтобы сохранить особенности объекта или движения из референсов.
Задайте model равным Model ID этого подраздела, а operation — reference_to_video. Используйте только поля генерации из таблицы ниже. Материалы передавайте в массиве media.
| Поле | Тип | Обязательно | Допустимые значения или диапазон | По умолчанию |
|---|---|---|---|---|
audio.mode | string | Нет | on, off | on |
duration.mode | string | Нет | fixed, auto | fixed |
duration.seconds | integer | Нет | 4–15, шаг 1 с; только для фиксированной длительности | Нет |
output.aspect_ratio | string | Нет | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | Нет | mp4 | mp4 |
output.resolution | string | Нет | 480p, 720p | 720p |
prompt | string | Да | строка | Нет |
watermark | boolean | Нет | false, true | false |
Требования к материалам
| Роль материала | Тип и количество | Форматы | Ограничения на файл |
|---|---|---|---|
reference_image | image, необязательно, не более 9 | jpeg, png, webp, bmp, tiff, gif, heic, heif | размер 1–31457279 байт; ширина 300–6000 px; высота 300–6000 px |
reference_video | video, необязательно, не более 3 | mp4, mov | размер не более 200 MB; ширина 300–6000 px; высота 300–6000 px; длительность 2–15 с; частота кадров не ниже 24 fps, и не выше 60 fps; всего для этой роли не более 15 с |
reference_audio | audio, необязательно, не более 3 | wav, mp3 | размер не более 15 MB; длительность 2–15 с; всего для этой роли не более 15 с |
Обязательность материалов также определяется ограничениями сочетаний ниже.
Ограничения сочетаний
- Для
duration.mode="fixed"требуетсяduration.seconds. При явном указанииfixedтакже задайте число секунд. - При
duration.mode="auto"не передавайтеduration.seconds. - Передайте хотя бы одну роль:
reference_image,reference_video,reference_audio. - Референсное аудио нельзя использовать отдельно. Также передайте референсное изображение или видео.
Пример запроса
Сохраните JSON ниже в request.json, затем следуйте общему процессу: сначала расчёт, после подтверждения — создание.
{ "model": "doubao-seedance-2-0-mini-260615", "operation": "reference_to_video", "prompt": "Create a product video of the blue ceramic mug in the reference image. Keep its shape and color.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "reference", "type": "image", "role": "reference_image", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Частые ошибки 422
| Код ошибки 422 | Действие |
|---|---|
enum / range / step | Исправьте значения и шаг по таблице полей этого подраздела. |
unsupported_field | Удалите поля, отсутствующие в таблице этой операции. |
requires | Добавьте секунды, пропорции, настройки аудио или материалы по ограничениям сочетаний этого подраздела. |
excludes | Удалите поля, несовместимые с автоматической длительностью или последним кадром. |
count / media_role | Исправьте роли и количество по таблице материалов этого подраздела. |
video_input_unsupported | Проверьте публичный HTTPS-адрес, Content-Type и формат файла, затем повторите расчёт. |
doubao-seedance-2-5-260628
Используйте эту операцию, чтобы сохранить особенности объекта или движения из референсов.
Задайте model равным Model ID этого подраздела, а operation — reference_to_video. Используйте только поля генерации из таблицы ниже. Материалы передавайте в массиве media.
| Поле | Тип | Обязательно | Допустимые значения или диапазон | По умолчанию |
|---|---|---|---|---|
audio.mode | string | Нет | on, off | on |
duration.mode | string | Нет | fixed, auto | auto |
duration.seconds | integer | Нет | 4–30, шаг 1 с; только для фиксированной длительности | Нет |
output.aspect_ratio | string | Нет | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | Нет | mp4 | mp4 |
output.resolution | string | Нет | 480p, 720p, 1080p | 720p |
prompt | string | Да | строка | Нет |
watermark | boolean | Нет | false, true | false |
Требования к материалам
| Роль материала | Тип и количество | Форматы | Ограничения на файл |
|---|---|---|---|
reference_image | image, необязательно, не более 30 | jpeg, png, webp, bmp, tiff, gif, heic, heif | размер 1–31457279 байт; ширина 300–6000 px; высота 300–6000 px |
reference_video | video, необязательно, не более 10 | mp4, mov | размер не более 200 MB; ширина 300–6000 px; высота 300–6000 px; длительность 2–30 с; частота кадров не ниже 24 fps, и не выше 60 fps; всего для этой роли не более 30 с |
reference_audio | audio, необязательно, не более 10 | wav, mp3 | размер не более 15 MB; длительность 2–30 с; всего для этой роли не более 30 с |
Обязательность материалов также определяется ограничениями сочетаний ниже.
Ограничения сочетаний
- Для
duration.mode="fixed"требуетсяduration.seconds. При явном указанииfixedтакже задайте число секунд. - При
duration.mode="auto"не передавайтеduration.seconds. - Передайте хотя бы одну роль:
reference_image,reference_video,reference_audio.
Пример запроса
Сохраните JSON ниже в request.json, затем следуйте общему процессу: сначала расчёт, после подтверждения — создание.
{ "model": "doubao-seedance-2-5-260628", "operation": "reference_to_video", "prompt": "Create a product video of the blue ceramic mug in the reference image. Keep its shape and color.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "reference", "type": "image", "role": "reference_image", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Частые ошибки 422
| Код ошибки 422 | Действие |
|---|---|
enum / range / step | Исправьте значения и шаг по таблице полей этого подраздела. |
unsupported_field | Удалите поля, отсутствующие в таблице этой операции. |
requires | Добавьте секунды, пропорции, настройки аудио или материалы по ограничениям сочетаний этого подраздела. |
excludes | Удалите поля, несовместимые с автоматической длительностью или последним кадром. |
count / media_role | Исправьте роли и количество по таблице материалов этого подраздела. |
video_input_unsupported | Проверьте публичный HTTPS-адрес, Content-Type и формат файла, затем повторите расчёт. |
Официальные материалы
При обращении к BetterToken используйте поля этой страницы и соответствующую операцию из актуального каталога моделей.

