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-i2v | image_to_video | 2–15, шаг 1 | 720p, 1080p | не передавайте | provider_default | first_frame, last_frame, driving_audio |
wan2.7-r2v | reference_to_video | 2–15, шаг 1 | 720p, 1080p | 16:9, 9:16, 1:1, 4:3, 3:4 | provider_default | reference_image, reference_video |
wan2.7-t2v | text_to_video | 2–15, шаг 1 | 720p, 1080p | 16:9, 9:16, 1:1, 4:3, 3:4 | provider_default | driving_audio |
wan2.7-videoedit | video_edit | 2–15, шаг 1; доступно auto | 720p, 1080p | не передавайте | provider_default | base_video |
wan3.0-video-prime | image_to_video | 2–30, шаг 1; доступно auto | 480p, 720p, 1080p | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | on, off | first_frame, last_frame |
wan3.0-video-prime | reference_to_video | 2–30, шаг 1; доступно auto | 480p, 720p, 1080p | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | on, off | reference_image, reference_video, reference_audio |
wan3.0-video-prime | text_to_video | 2–30, шаг 1; доступно auto | 480p, 720p, 1080p | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | on, off | Нет |
wan3.0-video | image_to_video | 2–30, шаг 1; доступно auto | 480p, 720p, 1080p | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | on, off | first_frame, last_frame |
wan3.0-video | reference_to_video | 2–30, шаг 1; доступно auto | 480p, 720p, 1080p | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | on, off | reference_image, reference_video, reference_audio |
wan3.0-video | text_to_video | 2–30, шаг 1; доступно auto | 480p, 720p, 1080p | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | on, 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.mode | string | Нет | provider_default | provider_default |
duration.mode | string | Нет | fixed | fixed |
duration.seconds | integer | Нет | 2–15, шаг 1 с; только для фиксированной длительности | 5 |
output.aspect_ratio | string | Нет | 16:9, 9:16, 1:1, 4:3, 3:4 | 16:9 |
output.format | string | Нет | mp4 | mp4 |
output.resolution | string | Нет | 720p, 1080p | 1080p |
prompt | string | Да | строка | Нет |
provider_options.alibaba.prompt_extend | boolean | Нет | true / false; управляет расширением промпта | true |
seed | integer | Нет | 0–2147483647, шаг 1; случайное зерно; может быть 0 | Нет |
watermark | boolean | Нет | false, true | false |
Требования к материалам
| Роль материала | Тип и количество | Форматы | Ограничения на файл |
|---|---|---|---|
driving_audio | audio, необязательно, не более 1 | wav, 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.mode | string | Нет | on, off | on |
duration.mode | string | Нет | fixed, auto | fixed |
duration.seconds | integer | Нет | 2–30, шаг 1 с; только для фиксированной длительности | 5 |
output.aspect_ratio | string | Нет | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | adaptive |
output.format | string | Нет | mp4 | mp4 |
output.resolution | string | Нет | 480p, 720p, 1080p | 1080p |
prompt | string | Да | строка | Нет |
provider_options.alibaba.prompt_extend | boolean | Нет | true / false; управляет расширением промпта | true |
seed | integer | Нет | 0–2147483647, шаг 1; случайное зерно; может быть 0 | Нет |
watermark | boolean | Нет | false, true | false |
Требования к материалам
Эта операция не принимает материалы.
Ограничения сочетаний
- Для
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.mode | string | Нет | on, off | on |
duration.mode | string | Нет | fixed, auto | fixed |
duration.seconds | integer | Нет | 2–30, шаг 1 с; только для фиксированной длительности | 5 |
output.aspect_ratio | string | Нет | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | adaptive |
output.format | string | Нет | mp4 | mp4 |
output.resolution | string | Нет | 480p, 720p, 1080p | 1080p |
prompt | string | Да | строка | Нет |
provider_options.alibaba.prompt_extend | boolean | Нет | true / false; управляет расширением промпта | true |
seed | integer | Нет | 0–2147483647, шаг 1; случайное зерно; может быть 0 | Нет |
watermark | boolean | Нет | false, true | false |
Требования к материалам
Эта операция не принимает материалы.
Ограничения сочетаний
- Для
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.mode | string | Нет | provider_default | provider_default |
duration.mode | string | Нет | fixed | fixed |
duration.seconds | integer | Нет | 2–15, шаг 1 с; только для фиксированной длительности | 5 |
output.format | string | Нет | mp4 | mp4 |
output.resolution | string | Нет | 720p, 1080p | 1080p |
prompt | string | Да | строка | Нет |
provider_options.alibaba.prompt_extend | boolean | Нет | true / false; управляет расширением промпта | true |
seed | integer | Нет | 0–2147483647, шаг 1; случайное зерно; может быть 0 | Нет |
watermark | boolean | Нет | false, true | false |
Требования к материалам
| Роль материала | Тип и количество | Форматы | Ограничения на файл |
|---|---|---|---|
first_frame | image, 1 (обязательно) | jpeg, jpg, png, bmp, webp | размер не более 20 MB; ширина 240–8000 px; высота 240–8000 px |
last_frame | image, необязательно, не более 1 | jpeg, jpg, png, bmp, webp | размер не более 20 MB; ширина 240–8000 px; высота 240–8000 px |
driving_audio | audio, необязательно, не более 1 | wav, 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.mode | string | Нет | on, off | on |
duration.mode | string | Нет | fixed, auto | fixed |
duration.seconds | integer | Нет | 2–30, шаг 1 с; только для фиксированной длительности | 5 |
output.aspect_ratio | string | Нет | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | adaptive |
output.format | string | Нет | mp4 | mp4 |
output.resolution | string | Нет | 480p, 720p, 1080p | 1080p |
prompt | string | Да | строка | Нет |
provider_options.alibaba.prompt_extend | boolean | Нет | true / false; управляет расширением промпта | true |
seed | integer | Нет | 0–2147483647, шаг 1; случайное зерно; может быть 0 | Нет |
watermark | boolean | Нет | false, true | false |
Требования к материалам
| Роль материала | Тип и количество | Форматы | Ограничения на файл |
|---|---|---|---|
first_frame | image, 1 (обязательно) | jpeg, jpg, png, bmp, webp | размер не более 20 MB; ширина 240–8000 px; высота 240–8000 px |
last_frame | image, необязательно, не более 1 | jpeg, 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.mode | string | Нет | on, off | on |
duration.mode | string | Нет | fixed, auto | fixed |
duration.seconds | integer | Нет | 2–30, шаг 1 с; только для фиксированной длительности | 5 |
output.aspect_ratio | string | Нет | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | adaptive |
output.format | string | Нет | mp4 | mp4 |
output.resolution | string | Нет | 480p, 720p, 1080p | 1080p |
prompt | string | Да | строка | Нет |
provider_options.alibaba.prompt_extend | boolean | Нет | true / false; управляет расширением промпта | true |
seed | integer | Нет | 0–2147483647, шаг 1; случайное зерно; может быть 0 | Нет |
watermark | boolean | Нет | false, true | false |
Требования к материалам
| Роль материала | Тип и количество | Форматы | Ограничения на файл |
|---|---|---|---|
first_frame | image, 1 (обязательно) | jpeg, jpg, png, bmp, webp | размер не более 20 MB; ширина 240–8000 px; высота 240–8000 px |
last_frame | image, необязательно, не более 1 | jpeg, 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.mode | string | Нет | provider_default | provider_default |
duration.mode | string | Нет | fixed | fixed |
duration.seconds | integer | Нет | 2–15, шаг 1 с; только для фиксированной длительности | 5 |
output.aspect_ratio | string | Нет | 16:9, 9:16, 1:1, 4:3, 3:4 | 16:9 |
output.format | string | Нет | mp4 | mp4 |
output.resolution | string | Нет | 720p, 1080p | 1080p |
prompt | string | Да | строка | Нет |
provider_options.alibaba.prompt_extend | boolean | Нет | true / false; управляет расширением промпта | true |
seed | integer | Нет | 0–2147483647, шаг 1; случайное зерно; может быть 0 | Нет |
watermark | boolean | Нет | false, true | false |
Требования к материалам
| Роль материала | Тип и количество | Форматы | Ограничения на файл |
|---|---|---|---|
reference_image | image, необязательно, не более 10 | jpeg, jpg, png, bmp, webp | размер не более 20 MB; ширина 240–8000 px; высота 240–8000 px |
reference_video | video, необязательно, не более 5 | mp4, 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.mode | string | Нет | on, off | on |
duration.mode | string | Нет | fixed, auto | fixed |
duration.seconds | integer | Нет | 2–30, шаг 1 с; только для фиксированной длительности | 5 |
output.aspect_ratio | string | Нет | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | adaptive |
output.format | string | Нет | mp4 | mp4 |
output.resolution | string | Нет | 480p, 720p, 1080p | 1080p |
prompt | string | Да | строка | Нет |
provider_options.alibaba.prompt_extend | boolean | Нет | true / false; управляет расширением промпта | true |
seed | integer | Нет | 0–2147483647, шаг 1; случайное зерно; может быть 0 | Нет |
watermark | boolean | Нет | false, true | false |
Требования к материалам
| Роль материала | Тип и количество | Форматы | Ограничения на файл |
|---|---|---|---|
reference_image | image, необязательно, не более 10 | jpeg, jpg, png, bmp, webp | размер не более 20 MB; ширина 240–8000 px; высота 240–8000 px |
reference_video | video, необязательно, не более 5 | mp4, mov | размер не более 100 MB; ширина 240–4096 px; высота 240–4096 px; длительность 1–15 с; частота кадров не ниже 16 fps; всего для этой роли не более 15 с |
reference_audio | audio, необязательно, не более 5 | wav, 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.mode | string | Нет | on, off | on |
duration.mode | string | Нет | fixed, auto | fixed |
duration.seconds | integer | Нет | 2–30, шаг 1 с; только для фиксированной длительности | 5 |
output.aspect_ratio | string | Нет | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | adaptive |
output.format | string | Нет | mp4 | mp4 |
output.resolution | string | Нет | 480p, 720p, 1080p | 1080p |
prompt | string | Да | строка | Нет |
provider_options.alibaba.prompt_extend | boolean | Нет | true / false; управляет расширением промпта | true |
seed | integer | Нет | 0–2147483647, шаг 1; случайное зерно; может быть 0 | Нет |
watermark | boolean | Нет | false, true | false |
Требования к материалам
| Роль материала | Тип и количество | Форматы | Ограничения на файл |
|---|---|---|---|
reference_image | image, необязательно, не более 10 | jpeg, jpg, png, bmp, webp | размер не более 20 MB; ширина 240–8000 px; высота 240–8000 px |
reference_video | video, необязательно, не более 5 | mp4, mov | размер не более 100 MB; ширина 240–4096 px; высота 240–4096 px; длительность 1–15 с; частота кадров не ниже 16 fps; всего для этой роли не более 15 с |
reference_audio | audio, необязательно, не более 5 | wav, 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.mode | string | Нет | provider_default | provider_default |
duration.mode | string | Нет | fixed, auto | auto |
duration.seconds | integer | Нет | 2–15, шаг 1 с; только для фиксированной длительности | Нет |
output.format | string | Нет | mp4 | mp4 |
output.resolution | string | Нет | 720p, 1080p | 1080p |
prompt | string | Да | строка | Нет |
provider_options.alibaba.prompt_extend | boolean | Нет | true / false; управляет расширением промпта | true |
seed | integer | Нет | 0–2147483647, шаг 1; случайное зерно; может быть 0 | Нет |
watermark | boolean | Нет | false, true | false |
Требования к материалам
| Роль материала | Тип и количество | Форматы | Ограничения на файл |
|---|---|---|---|
base_video | video, 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 используйте поля этой страницы и соответствующую операцию из актуального каталога моделей.

