Перейти к содержимому
Зарегистрироваться бесплатно
Seedance

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-SRimage_to_video5–10, шаг 5720p, 1080p, 4k16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offfirst_frame
ByteDance-Seedance-2.0-SRtext_to_video5–10, шаг 5720p, 1080p, 4k16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offНет
ByteDance-Seedance-2.5-SRimage_to_video5–10, шаг 5720p, 1080p16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offfirst_frame
ByteDance-Seedance-2.5-SRtext_to_video5–10, шаг 5720p, 1080p16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offНет
doubao-seedance-2-0-260128image_to_video4–15, шаг 1; доступно auto480p, 720p, 1080p, 4k16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offfirst_frame, last_frame
doubao-seedance-2-0-260128reference_to_video4–15, шаг 1; доступно auto480p, 720p, 1080p, 4k16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offreference_image, reference_video, reference_audio
doubao-seedance-2-0-260128text_to_video4–15, шаг 1; доступно auto480p, 720p, 1080p, 4k16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offНет
doubao-seedance-2-0-fast-260128image_to_video4–15, шаг 1; доступно auto480p, 720p16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offfirst_frame, last_frame
doubao-seedance-2-0-fast-260128reference_to_video4–15, шаг 1; доступно auto480p, 720p16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offreference_image, reference_video, reference_audio
doubao-seedance-2-0-fast-260128text_to_video4–15, шаг 1; доступно auto480p, 720p16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offНет
doubao-seedance-2-0-mini-260615image_to_video4–15, шаг 1; доступно auto480p, 720p16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offfirst_frame, last_frame
doubao-seedance-2-0-mini-260615reference_to_video4–15, шаг 1; доступно auto480p, 720p16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offreference_image, reference_video, reference_audio
doubao-seedance-2-0-mini-260615text_to_video4–15, шаг 1; доступно auto480p, 720p16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offНет
doubao-seedance-2-5-260628image_to_video4–30, шаг 1; доступно auto480p, 720p, 1080padaptiveon, offfirst_frame, last_frame
doubao-seedance-2-5-260628reference_to_video4–30, шаг 1; доступно auto480p, 720p, 1080p16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offreference_image, reference_video, reference_audio
doubao-seedance-2-5-260628text_to_video4–30, шаг 1; доступно auto480p, 720p, 1080p16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offНет

Для фиксированной длительности обе модели SR принимают только 5 или 10 секунд. Модели для Китая и модели SR имеют разные Model ID. Не переносите ограничения полей и материалов одной модели на другую.

Примеры материалов

Примеры генерации по изображению и референсу используют синюю керамическую кружку на белом столе. Оставьте пример изображения для проверки или сначала замените его публичным HTTPS-материалом, который вы вправе использовать и который соответствует ограничениям этой страницы.

Референс для генерации видео: синяя керамическая кружка на белом столе

Генерация по тексту

ByteDance-Seedance-2.0-SR

Используйте эту операцию, если у вас есть только текстовое описание.

Задайте model равным Model ID этого подраздела, а operation — text_to_video. Используйте только поля генерации из таблицы ниже. Материалы передавайте в массиве media.

ПолеТипОбязательноДопустимые значения или диапазонПо умолчанию
audio.modestringНетon, offon
duration.modestringНетfixedfixed
duration.secondsintegerНет5–10, шаг 5 с; только для фиксированной длительности5
output.aspect_ratiostringНет16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive16:9
output.formatstringНетmp4mp4
output.resolutionstringНет720p, 1080p, 4k720p
promptstringДастрокаНет
watermarkbooleanНетfalsefalse

Требования к материалам

Эта операция не принимает материалы.

Ограничения сочетаний

  • Для 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.modestringНетon, offon
duration.modestringНетfixedfixed
duration.secondsintegerНет5–10, шаг 5 с; только для фиксированной длительности5
output.aspect_ratiostringНет16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive16:9
output.formatstringНетmp4mp4
output.resolutionstringНет720p, 1080p720p
promptstringДастрокаНет
watermarkbooleanНетfalsefalse

Требования к материалам

Эта операция не принимает материалы.

Ограничения сочетаний

  • Для 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.modestringНетon, offon
duration.modestringНетfixed, autofixed
duration.secondsintegerНет4–15, шаг 1 с; только для фиксированной длительностиНет
output.aspect_ratiostringНет16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringНетmp4mp4
output.resolutionstringНет480p, 720p, 1080p, 4k720p
promptstringДастрокаНет
watermarkbooleanНетfalse, truefalse

Требования к материалам

Эта операция не принимает материалы.

Ограничения сочетаний

  • Для 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.modestringНетon, offon
duration.modestringНетfixed, autofixed
duration.secondsintegerНет4–15, шаг 1 с; только для фиксированной длительностиНет
output.aspect_ratiostringНет16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringНетmp4mp4
output.resolutionstringНет480p, 720p720p
promptstringДастрокаНет
watermarkbooleanНетfalse, truefalse

Требования к материалам

Эта операция не принимает материалы.

Ограничения сочетаний

  • Для 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.modestringНетon, offon
duration.modestringНетfixed, autofixed
duration.secondsintegerНет4–15, шаг 1 с; только для фиксированной длительностиНет
output.aspect_ratiostringНет16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringНетmp4mp4
output.resolutionstringНет480p, 720p720p
promptstringДастрокаНет
watermarkbooleanНетfalse, truefalse

Требования к материалам

Эта операция не принимает материалы.

Ограничения сочетаний

  • Для 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.modestringНетon, offon
duration.modestringНетfixed, autoauto
duration.secondsintegerНет4–30, шаг 1 с; только для фиксированной длительностиНет
output.aspect_ratiostringНет16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringНетmp4mp4
output.resolutionstringНет480p, 720p, 1080p720p
promptstringДастрокаНет
watermarkbooleanНетfalse, truefalse

Требования к материалам

Эта операция не принимает материалы.

Ограничения сочетаний

  • Для 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.modestringНетon, offon
duration.modestringНетfixedfixed
duration.secondsintegerНет5–10, шаг 5 с; только для фиксированной длительности5
output.aspect_ratiostringНет16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive16:9
output.formatstringНетmp4mp4
output.resolutionstringНет720p, 1080p, 4k720p
promptstringДастрокаНет
watermarkbooleanНетfalsefalse

Требования к материалам

Роль материалаТип и количествоФорматыОграничения на файл
first_frameimage, 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.modestringНетon, offon
duration.modestringНетfixedfixed
duration.secondsintegerНет5–10, шаг 5 с; только для фиксированной длительности5
output.aspect_ratiostringНет16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive16:9
output.formatstringНетmp4mp4
output.resolutionstringНет720p, 1080p720p
promptstringДастрокаНет
watermarkbooleanНетfalsefalse

Требования к материалам

Роль материалаТип и количествоФорматыОграничения на файл
first_frameimage, 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.modestringНетon, offon
duration.modestringНетfixed, autofixed
duration.secondsintegerНет4–15, шаг 1 с; только для фиксированной длительностиНет
output.aspect_ratiostringНет16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringНетmp4mp4
output.resolutionstringНет480p, 720p, 1080p, 4k720p
promptstringДастрокаНет
watermarkbooleanНетfalse, truefalse

Требования к материалам

Роль материалаТип и количествоФорматыОграничения на файл
first_frameimage, 1 (обязательно)jpeg, png, webp, bmp, tiff, gif, heic, heifразмер 1–31457279 байт; ширина 300–6000 px; высота 300–6000 px
last_frameimage, необязательно, не более 1jpeg, 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.modestringНетon, offon
duration.modestringНетfixed, autofixed
duration.secondsintegerНет4–15, шаг 1 с; только для фиксированной длительностиНет
output.aspect_ratiostringНет16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringНетmp4mp4
output.resolutionstringНет480p, 720p720p
promptstringДастрокаНет
watermarkbooleanНетfalse, truefalse

Требования к материалам

Роль материалаТип и количествоФорматыОграничения на файл
first_frameimage, 1 (обязательно)jpeg, png, webp, bmp, tiff, gif, heic, heifразмер 1–31457279 байт; ширина 300–6000 px; высота 300–6000 px
last_frameimage, необязательно, не более 1jpeg, 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.modestringНетon, offon
duration.modestringНетfixed, autofixed
duration.secondsintegerНет4–15, шаг 1 с; только для фиксированной длительностиНет
output.aspect_ratiostringНет16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringНетmp4mp4
output.resolutionstringНет480p, 720p720p
promptstringДастрокаНет
watermarkbooleanНетfalse, truefalse

Требования к материалам

Роль материалаТип и количествоФорматыОграничения на файл
first_frameimage, 1 (обязательно)jpeg, png, webp, bmp, tiff, gif, heic, heifразмер 1–31457279 байт; ширина 300–6000 px; высота 300–6000 px
last_frameimage, необязательно, не более 1jpeg, 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.modestringНетon, offon
duration.modestringНетfixed, autoauto
duration.secondsintegerНет4–30, шаг 1 с; только для фиксированной длительностиНет
output.aspect_ratiostringНетadaptiveadaptive
output.formatstringНетmp4mp4
output.resolutionstringНет480p, 720p, 1080p720p
promptstringДастрокаНет
watermarkbooleanНетfalse, truefalse

Требования к материалам

Роль материалаТип и количествоФорматыОграничения на файл
first_frameimage, 1 (обязательно)jpeg, png, webp, bmp, tiff, gif, heic, heifразмер 1–31457279 байт; ширина 300–6000 px; высота 300–6000 px
last_frameimage, необязательно, не более 1jpeg, 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.modestringНетon, offon
duration.modestringНетfixed, autofixed
duration.secondsintegerНет4–15, шаг 1 с; только для фиксированной длительностиНет
output.aspect_ratiostringНет16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringНетmp4mp4
output.resolutionstringНет480p, 720p, 1080p, 4k720p
promptstringДастрокаНет
watermarkbooleanНетfalse, truefalse

Требования к материалам

Роль материалаТип и количествоФорматыОграничения на файл
reference_imageimage, необязательно, не более 9jpeg, png, webp, bmp, tiff, gif, heic, heifразмер 1–31457279 байт; ширина 300–6000 px; высота 300–6000 px
reference_videovideo, необязательно, не более 3mp4, movразмер не более 200 MB; ширина 300–6000 px; высота 300–6000 px; длительность 2–15 с; частота кадров не ниже 24 fps, и не выше 60 fps; всего для этой роли не более 15 с
reference_audioaudio, необязательно, не более 3wav, 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.modestringНетon, offon
duration.modestringНетfixed, autofixed
duration.secondsintegerНет4–15, шаг 1 с; только для фиксированной длительностиНет
output.aspect_ratiostringНет16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringНетmp4mp4
output.resolutionstringНет480p, 720p720p
promptstringДастрокаНет
watermarkbooleanНетfalse, truefalse

Требования к материалам

Роль материалаТип и количествоФорматыОграничения на файл
reference_imageimage, необязательно, не более 9jpeg, png, webp, bmp, tiff, gif, heic, heifразмер 1–31457279 байт; ширина 300–6000 px; высота 300–6000 px
reference_videovideo, необязательно, не более 3mp4, movразмер не более 200 MB; ширина 300–6000 px; высота 300–6000 px; длительность 2–15 с; частота кадров не ниже 24 fps, и не выше 60 fps; всего для этой роли не более 15 с
reference_audioaudio, необязательно, не более 3wav, 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.modestringНетon, offon
duration.modestringНетfixed, autofixed
duration.secondsintegerНет4–15, шаг 1 с; только для фиксированной длительностиНет
output.aspect_ratiostringНет16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringНетmp4mp4
output.resolutionstringНет480p, 720p720p
promptstringДастрокаНет
watermarkbooleanНетfalse, truefalse

Требования к материалам

Роль материалаТип и количествоФорматыОграничения на файл
reference_imageimage, необязательно, не более 9jpeg, png, webp, bmp, tiff, gif, heic, heifразмер 1–31457279 байт; ширина 300–6000 px; высота 300–6000 px
reference_videovideo, необязательно, не более 3mp4, movразмер не более 200 MB; ширина 300–6000 px; высота 300–6000 px; длительность 2–15 с; частота кадров не ниже 24 fps, и не выше 60 fps; всего для этой роли не более 15 с
reference_audioaudio, необязательно, не более 3wav, 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.modestringНетon, offon
duration.modestringНетfixed, autoauto
duration.secondsintegerНет4–30, шаг 1 с; только для фиксированной длительностиНет
output.aspect_ratiostringНет16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringНетmp4mp4
output.resolutionstringНет480p, 720p, 1080p720p
promptstringДастрокаНет
watermarkbooleanНетfalse, truefalse

Требования к материалам

Роль материалаТип и количествоФорматыОграничения на файл
reference_imageimage, необязательно, не более 30jpeg, png, webp, bmp, tiff, gif, heic, heifразмер 1–31457279 байт; ширина 300–6000 px; высота 300–6000 px
reference_videovideo, необязательно, не более 10mp4, movразмер не более 200 MB; ширина 300–6000 px; высота 300–6000 px; длительность 2–30 с; частота кадров не ниже 24 fps, и не выше 60 fps; всего для этой роли не более 30 с
reference_audioaudio, необязательно, не более 10wav, 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 используйте поля этой страницы и соответствующую операцию из актуального каталога моделей.