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

Wan Video API: текст, изображения, референсы и редактирование

Подключите Wan с BetterToken API Key и выбирайте поля, материалы и способ генерации по Model ID и операции.

Создавайте видео по тексту, первому кадру или референсам либо редактируйте готовое видео. 3.0 и Prime поддерживают три операции генерации. Для 2.7 выбирайте отдельный 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ОперацияДлительность (секунды)Качество выводаПропорцииАудиоРоли материалов
wan2.7-i2vimage_to_video2–15, шаг 1720p, 1080pне передавайтеprovider_defaultfirst_frame, last_frame, driving_audio
wan2.7-r2vreference_to_video2–15, шаг 1720p, 1080p16:9, 9:16, 1:1, 4:3, 3:4provider_defaultreference_image, reference_video
wan2.7-t2vtext_to_video2–15, шаг 1720p, 1080p16:9, 9:16, 1:1, 4:3, 3:4provider_defaultdriving_audio
wan2.7-videoeditvideo_edit2–15, шаг 1; доступно auto720p, 1080pне передавайтеprovider_defaultbase_video
wan3.0-video-primeimage_to_video2–30, шаг 1; доступно auto480p, 720p, 1080padaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16on, offfirst_frame, last_frame
wan3.0-video-primereference_to_video2–30, шаг 1; доступно auto480p, 720p, 1080padaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16on, offreference_image, reference_video, reference_audio
wan3.0-video-primetext_to_video2–30, шаг 1; доступно auto480p, 720p, 1080padaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16on, offНет
wan3.0-videoimage_to_video2–30, шаг 1; доступно auto480p, 720p, 1080padaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16on, offfirst_frame, last_frame
wan3.0-videoreference_to_video2–30, шаг 1; доступно auto480p, 720p, 1080padaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16on, offreference_image, reference_video, reference_audio
wan3.0-videotext_to_video2–30, шаг 1; доступно auto480p, 720p, 1080padaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16on, offНет

Для image-to-video (wan2.7-i2v, а также wan3.0-video / wan3.0-video-prime с adaptive) и reference-to-video с adaptive соотношение сторон результата повторяет входное изображение; уровень вывода задаёт общее число пикселей, а не фиксированные размеры. С квадратным примером на этой странице 720p в наших тестах дал 960×960, а 480p — 640×640. Чтобы получить фиксированный горизонтальный или вертикальный кадр, явно передайте output.aspect_ratio (wan2.7-i2v это поле не принимает — используйте изображение с нужным соотношением сторон).

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

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

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

Пример редактирования использует видео мальчика на городской площади: около 5,04 секунды, 1280 × 720, 24 fps. Оно передаётся как base_video, а не как референсное изображение.

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

wan2.7-t2v

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

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

ПолеТипОбязательноДопустимые значения или диапазонПо умолчанию
audio.modestringНетprovider_defaultprovider_default
duration.modestringНетfixedfixed
duration.secondsintegerНет2–15, шаг 1 с; только для фиксированной длительности5
output.aspect_ratiostringНет16:9, 9:16, 1:1, 4:3, 3:416:9
output.formatstringНетmp4mp4
output.resolutionstringНет720p, 1080p1080p
promptstringДастрокаНет
provider_options.alibaba.prompt_extendbooleanНетtrue / false; управляет расширением промптаtrue
seedintegerНет0–2147483647, шаг 1; случайное зерно; может быть 0Нет
watermarkbooleanНетfalse, truefalse

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

Роль материалаТип и количествоФорматыОграничения на файл
driving_audioaudio, необязательно, не более 1wav, mp3размер не более 15 MB; длительность 2–30 с

Обязательность материалов также определяется ограничениями сочетаний ниже.

Необязательный driving_audio задаёт управляющее аудио и использует type="audio". Это другая роль материала, чем reference_audio при генерации по референсам.

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

  • Для duration.mode="fixed" требуется duration.seconds. При явном указании fixed также задайте число секунд.

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

Сохраните JSON ниже в request.json, затем следуйте общему процессу: сначала расчёт, после подтверждения — создание.

{
"model": "wan2.7-t2v",
"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Добавьте секунды, пропорции, настройки аудио или материалы по ограничениям сочетаний этого подраздела.
count / media_roleИсправьте роли и количество по таблице материалов этого подраздела.
video_input_unsupportedПроверьте публичный HTTPS-адрес, Content-Type и формат файла, затем повторите расчёт.

wan3.0-video-prime

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

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

ПолеТипОбязательноДопустимые значения или диапазонПо умолчанию
audio.modestringНетon, offon
duration.modestringНетfixed, autofixed
duration.secondsintegerНет2–30, шаг 1 с; только для фиксированной длительности5
output.aspect_ratiostringНетadaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16adaptive
output.formatstringНетmp4mp4
output.resolutionstringНет480p, 720p, 1080p1080p
promptstringДастрокаНет
provider_options.alibaba.prompt_extendbooleanНетtrue / false; управляет расширением промптаtrue
seedintegerНет0–2147483647, шаг 1; случайное зерно; может быть 0Нет
watermarkbooleanНетfalse, truefalse

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

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

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

  • Для duration.mode="fixed" требуется duration.seconds. При явном указании fixed также задайте число секунд.
  • При duration.mode="auto" не передавайте duration.seconds.

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

Сохраните JSON ниже в request.json, затем следуйте общему процессу: сначала расчёт, после подтверждения — создание.

{
"model": "wan3.0-video-prime",
"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Удалите поля, несовместимые с автоматической длительностью или последним кадром.

wan3.0-video

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

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

ПолеТипОбязательноДопустимые значения или диапазонПо умолчанию
audio.modestringНетon, offon
duration.modestringНетfixed, autofixed
duration.secondsintegerНет2–30, шаг 1 с; только для фиксированной длительности5
output.aspect_ratiostringНетadaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16adaptive
output.formatstringНетmp4mp4
output.resolutionstringНет480p, 720p, 1080p1080p
promptstringДастрокаНет
provider_options.alibaba.prompt_extendbooleanНетtrue / false; управляет расширением промптаtrue
seedintegerНет0–2147483647, шаг 1; случайное зерно; может быть 0Нет
watermarkbooleanНетfalse, truefalse

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

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

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

  • Для duration.mode="fixed" требуется duration.seconds. При явном указании fixed также задайте число секунд.
  • При duration.mode="auto" не передавайте duration.seconds.

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

Сохраните JSON ниже в request.json, затем следуйте общему процессу: сначала расчёт, после подтверждения — создание.

{
"model": "wan3.0-video",
"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Удалите поля, несовместимые с автоматической длительностью или последним кадром.

Генерация по изображению

wan2.7-i2v

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

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

ПолеТипОбязательноДопустимые значения или диапазонПо умолчанию
audio.modestringНетprovider_defaultprovider_default
duration.modestringНетfixedfixed
duration.secondsintegerНет2–15, шаг 1 с; только для фиксированной длительности5
output.formatstringНетmp4mp4
output.resolutionstringНет720p, 1080p1080p
promptstringДастрокаНет
provider_options.alibaba.prompt_extendbooleanНетtrue / false; управляет расширением промптаtrue
seedintegerНет0–2147483647, шаг 1; случайное зерно; может быть 0Нет
watermarkbooleanНетfalse, truefalse

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

Роль материалаТип и количествоФорматыОграничения на файл
first_frameimage, 1 (обязательно)jpeg, jpg, png, bmp, webpразмер не более 20 MB; ширина 240–8000 px; высота 240–8000 px
last_frameimage, необязательно, не более 1jpeg, jpg, png, bmp, webpразмер не более 20 MB; ширина 240–8000 px; высота 240–8000 px
driving_audioaudio, необязательно, не более 1wav, mp3размер не более 15 MB; длительность 2–30 с

Обязательность материалов также определяется ограничениями сочетаний ниже.

Необязательный driving_audio задаёт управляющее аудио и использует type="audio". Это другая роль материала, чем reference_audio при генерации по референсам.

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

  • Для duration.mode="fixed" требуется duration.seconds. При явном указании fixed также задайте число секунд.
  • Обязательно передайте first_frame.

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

Сохраните JSON ниже в request.json, затем следуйте общему процессу: сначала расчёт, после подтверждения — создание.

{
"model": "wan2.7-i2v",
"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"
},
"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 и формат файла, затем повторите расчёт.

wan3.0-video-prime

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

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

ПолеТипОбязательноДопустимые значения или диапазонПо умолчанию
audio.modestringНетon, offon
duration.modestringНетfixed, autofixed
duration.secondsintegerНет2–30, шаг 1 с; только для фиксированной длительности5
output.aspect_ratiostringНетadaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16adaptive
output.formatstringНетmp4mp4
output.resolutionstringНет480p, 720p, 1080p1080p
promptstringДастрокаНет
provider_options.alibaba.prompt_extendbooleanНетtrue / false; управляет расширением промптаtrue
seedintegerНет0–2147483647, шаг 1; случайное зерно; может быть 0Нет
watermarkbooleanНетfalse, truefalse

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

Роль материалаТип и количествоФорматыОграничения на файл
first_frameimage, 1 (обязательно)jpeg, jpg, png, bmp, webpразмер не более 20 MB; ширина 240–8000 px; высота 240–8000 px
last_frameimage, необязательно, не более 1jpeg, jpg, png, bmp, webpразмер не более 20 MB; ширина 240–8000 px; высота 240–8000 px

Обязательность материалов также определяется ограничениями сочетаний ниже.

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

  • Для duration.mode="fixed" требуется duration.seconds. При явном указании fixed также задайте число секунд.
  • При duration.mode="auto" не передавайте duration.seconds.
  • Передайте хотя бы одну роль: first_frame, last_frame.

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

Сохраните JSON ниже в request.json, затем следуйте общему процессу: сначала расчёт, после подтверждения — создание.

{
"model": "wan3.0-video-prime",
"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 и формат файла, затем повторите расчёт.

wan3.0-video

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

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

ПолеТипОбязательноДопустимые значения или диапазонПо умолчанию
audio.modestringНетon, offon
duration.modestringНетfixed, autofixed
duration.secondsintegerНет2–30, шаг 1 с; только для фиксированной длительности5
output.aspect_ratiostringНетadaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16adaptive
output.formatstringНетmp4mp4
output.resolutionstringНет480p, 720p, 1080p1080p
promptstringДастрокаНет
provider_options.alibaba.prompt_extendbooleanНетtrue / false; управляет расширением промптаtrue
seedintegerНет0–2147483647, шаг 1; случайное зерно; может быть 0Нет
watermarkbooleanНетfalse, truefalse

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

Роль материалаТип и количествоФорматыОграничения на файл
first_frameimage, 1 (обязательно)jpeg, jpg, png, bmp, webpразмер не более 20 MB; ширина 240–8000 px; высота 240–8000 px
last_frameimage, необязательно, не более 1jpeg, jpg, png, bmp, webpразмер не более 20 MB; ширина 240–8000 px; высота 240–8000 px

Обязательность материалов также определяется ограничениями сочетаний ниже.

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

  • Для duration.mode="fixed" требуется duration.seconds. При явном указании fixed также задайте число секунд.
  • При duration.mode="auto" не передавайте duration.seconds.
  • Передайте хотя бы одну роль: first_frame, last_frame.

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

Сохраните JSON ниже в request.json, затем следуйте общему процессу: сначала расчёт, после подтверждения — создание.

{
"model": "wan3.0-video",
"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 и формат файла, затем повторите расчёт.

Генерация по референсам

wan2.7-r2v

Используйте эту операцию, чтобы сохранить особенности объекта или движения из референсов.

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

ПолеТипОбязательноДопустимые значения или диапазонПо умолчанию
audio.modestringНетprovider_defaultprovider_default
duration.modestringНетfixedfixed
duration.secondsintegerНет2–15, шаг 1 с; только для фиксированной длительности5
output.aspect_ratiostringНет16:9, 9:16, 1:1, 4:3, 3:416:9
output.formatstringНетmp4mp4
output.resolutionstringНет720p, 1080p1080p
promptstringДастрокаНет
provider_options.alibaba.prompt_extendbooleanНетtrue / false; управляет расширением промптаtrue
seedintegerНет0–2147483647, шаг 1; случайное зерно; может быть 0Нет
watermarkbooleanНетfalse, truefalse

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

Роль материалаТип и количествоФорматыОграничения на файл
reference_imageimage, необязательно, не более 10jpeg, jpg, png, bmp, webpразмер не более 20 MB; ширина 240–8000 px; высота 240–8000 px
reference_videovideo, необязательно, не более 5mp4, movразмер не более 100 MB; ширина 240–4096 px; высота 240–4096 px; длительность 1–15 с; частота кадров не ниже 16 fps; всего для этой роли не более 15 с

Обязательность материалов также определяется ограничениями сочетаний ниже.

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

  • Для duration.mode="fixed" требуется duration.seconds. При явном указании fixed также задайте число секунд.
  • Передайте хотя бы одну роль: reference_image, reference_video.

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

Сохраните JSON ниже в request.json, затем следуйте общему процессу: сначала расчёт, после подтверждения — создание.

{
"model": "wan2.7-r2v",
"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": "16:9"
},
"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Добавьте секунды, пропорции, настройки аудио или материалы по ограничениям сочетаний этого подраздела.
count / media_roleИсправьте роли и количество по таблице материалов этого подраздела.
video_input_unsupportedПроверьте публичный HTTPS-адрес, Content-Type и формат файла, затем повторите расчёт.

wan3.0-video-prime

Используйте эту операцию, чтобы сохранить особенности объекта или движения из референсов.

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

ПолеТипОбязательноДопустимые значения или диапазонПо умолчанию
audio.modestringНетon, offon
duration.modestringНетfixed, autofixed
duration.secondsintegerНет2–30, шаг 1 с; только для фиксированной длительности5
output.aspect_ratiostringНетadaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16adaptive
output.formatstringНетmp4mp4
output.resolutionstringНет480p, 720p, 1080p1080p
promptstringДастрокаНет
provider_options.alibaba.prompt_extendbooleanНетtrue / false; управляет расширением промптаtrue
seedintegerНет0–2147483647, шаг 1; случайное зерно; может быть 0Нет
watermarkbooleanНетfalse, truefalse

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

Роль материалаТип и количествоФорматыОграничения на файл
reference_imageimage, необязательно, не более 10jpeg, jpg, png, bmp, webpразмер не более 20 MB; ширина 240–8000 px; высота 240–8000 px
reference_videovideo, необязательно, не более 5mp4, movразмер не более 100 MB; ширина 240–4096 px; высота 240–4096 px; длительность 1–15 с; частота кадров не ниже 16 fps; всего для этой роли не более 15 с
reference_audioaudio, необязательно, не более 5wav, mp3размер не более 15 MB; длительность 1–15 с; всего для этой роли не более 15 с

Обязательность материалов также определяется ограничениями сочетаний ниже.

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

  • Для duration.mode="fixed" требуется duration.seconds. При явном указании fixed также задайте число секунд.
  • При duration.mode="auto" не передавайте duration.seconds.
  • Передайте хотя бы одну роль: reference_image, reference_video, reference_audio.
  • При наличии референсного видео сумма длительности всех входных видео и результата не должна превышать 30 секунд. При автоматической длительности этот остаток также ограничивает длительность результата.

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

Сохраните JSON ниже в request.json, затем следуйте общему процессу: сначала расчёт, после подтверждения — создание.

{
"model": "wan3.0-video-prime",
"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Удалите поля, несовместимые с автоматической длительностью или последним кадром.
sum_lteСократите общую длительность референсных видео или результата, чтобы сумма не превышала 30 секунд.
count / media_roleИсправьте роли и количество по таблице материалов этого подраздела.
video_input_unsupportedПроверьте публичный HTTPS-адрес, Content-Type и формат файла, затем повторите расчёт.

wan3.0-video

Используйте эту операцию, чтобы сохранить особенности объекта или движения из референсов.

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

ПолеТипОбязательноДопустимые значения или диапазонПо умолчанию
audio.modestringНетon, offon
duration.modestringНетfixed, autofixed
duration.secondsintegerНет2–30, шаг 1 с; только для фиксированной длительности5
output.aspect_ratiostringНетadaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16adaptive
output.formatstringНетmp4mp4
output.resolutionstringНет480p, 720p, 1080p1080p
promptstringДастрокаНет
provider_options.alibaba.prompt_extendbooleanНетtrue / false; управляет расширением промптаtrue
seedintegerНет0–2147483647, шаг 1; случайное зерно; может быть 0Нет
watermarkbooleanНетfalse, truefalse

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

Роль материалаТип и количествоФорматыОграничения на файл
reference_imageimage, необязательно, не более 10jpeg, jpg, png, bmp, webpразмер не более 20 MB; ширина 240–8000 px; высота 240–8000 px
reference_videovideo, необязательно, не более 5mp4, movразмер не более 100 MB; ширина 240–4096 px; высота 240–4096 px; длительность 1–15 с; частота кадров не ниже 16 fps; всего для этой роли не более 15 с
reference_audioaudio, необязательно, не более 5wav, mp3размер не более 15 MB; длительность 1–15 с; всего для этой роли не более 15 с

Обязательность материалов также определяется ограничениями сочетаний ниже.

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

  • Для duration.mode="fixed" требуется duration.seconds. При явном указании fixed также задайте число секунд.
  • При duration.mode="auto" не передавайте duration.seconds.
  • Передайте хотя бы одну роль: reference_image, reference_video, reference_audio.
  • При наличии референсного видео сумма длительности всех входных видео и результата не должна превышать 30 секунд. При автоматической длительности этот остаток также ограничивает длительность результата.

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

Сохраните JSON ниже в request.json, затем следуйте общему процессу: сначала расчёт, после подтверждения — создание.

{
"model": "wan3.0-video",
"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Удалите поля, несовместимые с автоматической длительностью или последним кадром.
sum_lteСократите общую длительность референсных видео или результата, чтобы сумма не превышала 30 секунд.
count / media_roleИсправьте роли и количество по таблице материалов этого подраздела.
video_input_unsupportedПроверьте публичный HTTPS-адрес, Content-Type и формат файла, затем повторите расчёт.

Редактирование видео

wan2.7-videoedit

Используйте эту операцию, чтобы изменить визуальное содержимое готового видео. Сначала подготовьте исходное видео, соответствующее ограничениям.

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

ПолеТипОбязательноДопустимые значения или диапазонПо умолчанию
audio.modestringНетprovider_defaultprovider_default
duration.modestringНетfixed, autoauto
duration.secondsintegerНет2–15, шаг 1 с; только для фиксированной длительностиНет
output.formatstringНетmp4mp4
output.resolutionstringНет720p, 1080p1080p
promptstringДастрокаНет
provider_options.alibaba.prompt_extendbooleanНетtrue / false; управляет расширением промптаtrue
seedintegerНет0–2147483647, шаг 1; случайное зерно; может быть 0Нет
watermarkbooleanНетfalse, truefalse

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

Роль материалаТип и количествоФорматыОграничения на файл
base_videovideo, 1 (обязательно)mp4, movразмер не более 100 MB; ширина 240–4096 px; высота 240–4096 px; длительность 1–15 с; частота кадров не ниже 16 fps; всего для этой роли не более 15 с

Обязательность материалов также определяется ограничениями сочетаний ниже.

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

  • Для duration.mode="fixed" требуется duration.seconds. При явном указании fixed также задайте число секунд.
  • Обязательно передайте base_video.
  • При duration.mode="auto" не передавайте duration.seconds.

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

Сохраните JSON ниже в request.json, затем следуйте общему процессу: сначала расчёт, после подтверждения — создание.

{
"model": "wan2.7-videoedit",
"operation": "video_edit",
"prompt": "Keep the boy and his motion in the source video. Give the city plaza warmer evening lighting.",
"duration": {
"mode": "auto"
},
"output": {
"resolution": "720p"
},
"media": [
{
"id": "base",
"type": "video",
"role": "base_video",
"source": "https://bettertoken.ai/video-api/shared/kling-hero-3.0.mp4"
}
]
}

Частые ошибки 422

Код ошибки 422Действие
enum / range / stepИсправьте значения и шаг по таблице полей этого подраздела.
unsupported_fieldУдалите поля, отсутствующие в таблице этой операции.
requiresДобавьте секунды, пропорции, настройки аудио или материалы по ограничениям сочетаний этого подраздела.
excludesУдалите поля, несовместимые с автоматической длительностью или последним кадром.
count / media_roleИсправьте роли и количество по таблице материалов этого подраздела.
video_input_unsupportedПроверьте публичный HTTPS-адрес, Content-Type и формат файла, затем повторите расчёт.

Официальные материалы

При обращении к BetterToken используйте поля этой страницы и соответствующую операцию из актуального каталога моделей.