API de vídeo de Wan: texto, imágenes, referencias y edición
Conecta Wan con tu BetterToken API Key y elige los campos, recursos y métodos de generación según el Model ID y la operación.
Puedes generar vídeos a partir de texto, un fotograma inicial o recursos de referencia, y también editar vídeos existentes. 3.0 y Prime admiten tres operaciones de generación; en 2.7, elige un Model ID específico para texto a vídeo, imagen a vídeo, generación con referencias o edición.
Prepara tu BetterToken API Key. La Base URL es https://bettertoken.ai/v1 y la autenticación usa Authorization: Bearer YOUR_API_KEY. Copia el Model ID exactamente, respetando mayúsculas y minúsculas.
Cada request.json de esta página sigue el mismo proceso: solicita un presupuesto, confirma la creación, consulta el estado y descarga. El presupuesto no inicia la generación; la creación envía una tarea de pago. Consulta los precios actuales en el model plaza.
Modelos y operaciones
La tabla enumera las opciones de cada operación. Consulta los valores predeterminados, las cantidades de recursos y las restricciones de combinación en cada sección. Los tamaños usan 1 MB = 1048576 bytes.
| Model ID | Operación | Duración (segundos) | Nivel de salida | Relación de aspecto | Audio | Roles de recursos |
|---|---|---|---|---|---|---|
wan2.7-i2v | image_to_video | 2–15, incremento 1 | 720p, 1080p | No enviar | provider_default | first_frame, last_frame, driving_audio |
wan2.7-r2v | reference_to_video | 2–15, incremento 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, incremento 1 | 720p, 1080p | 16:9, 9:16, 1:1, 4:3, 3:4 | provider_default | driving_audio |
wan2.7-videoedit | video_edit | 2–15, incremento 1; admite auto | 720p, 1080p | No enviar | provider_default | base_video |
wan3.0-video-prime | image_to_video | 2–30, incremento 1; admite 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, incremento 1; admite 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, incremento 1; admite auto | 480p, 720p, 1080p | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | on, off | Ninguno |
wan3.0-video | image_to_video | 2–30, incremento 1; admite 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, incremento 1; admite 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, incremento 1; admite auto | 480p, 720p, 1080p | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | on, off | Ninguno |
En imagen a vídeo (wan2.7-i2v, y wan3.0-video / wan3.0-video-prime con adaptive) y en referencia a vídeo con adaptive, el resultado sigue la relación de aspecto de la imagen de entrada; el nivel de salida fija el número total de píxeles, no unas dimensiones fijas. Con la imagen de ejemplo cuadrada de esta página, 720p devolvió 960×960 y 480p 640×640 en nuestras pruebas. Para un encuadre horizontal o vertical fijo, indique output.aspect_ratio de forma explícita (wan2.7-i2v no acepta este campo; use una imagen de entrada con la relación que necesite).
Recursos de ejemplo
Los ejemplos de generación desde imágenes y referencias usan una taza de cerámica azul sobre una mesa blanca. Puedes probar la imagen de ejemplo o sustituirla primero por recursos HTTPS públicos que tengas derecho a usar y que cumplan los límites de esta página.

El ejemplo de edición usa un vídeo de un niño en una plaza urbana, de unos 5.04 segundos, 1280 × 720 y 24 fps. Se envía como base_video, no como imagen de referencia.
De texto a vídeo
wan2.7-t2v
Usa esta operación para generar un vídeo cuando solo tienes una descripción de texto.
Establece model en el Model ID de esta sección y operation en text_to_video. Usa solo los campos de generación de la tabla siguiente; coloca los recursos en el array media.
| Campo | Tipo | Obligatorio | Opciones o rango | Valor predeterminado |
|---|---|---|---|---|
audio.mode | string | No | provider_default | provider_default |
duration.mode | string | No | fixed | fixed |
duration.seconds | integer | No | 2–15, incremento 1 s; solo con duración fija | 5 |
output.aspect_ratio | string | No | 16:9, 9:16, 1:1, 4:3, 3:4 | 16:9 |
output.format | string | No | mp4 | mp4 |
output.resolution | string | No | 720p, 1080p | 1080p |
prompt | string | Sí | Cadena | Ninguno |
provider_options.alibaba.prompt_extend | boolean | No | true / false; controla la ampliación del prompt | true |
seed | integer | No | 0–2147483647, incremento 1; semilla aleatoria; admite 0 | Ninguno |
watermark | boolean | No | false, true | false |
Requisitos de los recursos
| Rol del recurso | Tipo y cantidad | Formatos | Límites por archivo |
|---|---|---|---|
driving_audio | audio, opcional, máximo 1 | wav, mp3 | Tamaño máximo: 15 MB; duración: 2–30 s |
Los requisitos de recursos también deben cumplir las restricciones de combinación siguientes.
El recurso opcional driving_audio es audio que guía la generación y usa type="audio". Es un rol distinto de reference_audio, usado en la generación con referencias.
Restricciones de combinación
duration.mode="fixed"requiereduration.seconds. Cuando indiquesfixedexplícitamente, incluye también los segundos.
Ejemplo de solicitud
Guarda el JSON siguiente como request.json y sigue el proceso general: solicita un presupuesto y confirma antes de crear la tarea.
{ "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" }}Errores 422 frecuentes
| Código de error 422 | Solución |
|---|---|
enum / range / step | Ajusta los valores y el incremento según la tabla de campos de esta sección. |
unsupported_field | Elimina los campos que no figuran en la tabla de esta operación. |
requires | Completa los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección. |
count / media_role | Ajusta los roles y las cantidades según la tabla de recursos de esta sección. |
video_input_unsupported | Comprueba la URL HTTPS pública, el Content-Type y el formato del archivo, y solicita otro presupuesto. |
wan3.0-video-prime
Usa esta operación para generar un vídeo cuando solo tienes una descripción de texto.
Establece model en el Model ID de esta sección y operation en text_to_video. Usa solo los campos de generación de la tabla siguiente; coloca los recursos en el array media.
| Campo | Tipo | Obligatorio | Opciones o rango | Valor predeterminado |
|---|---|---|---|---|
audio.mode | string | No | on, off | on |
duration.mode | string | No | fixed, auto | fixed |
duration.seconds | integer | No | 2–30, incremento 1 s; solo con duración fija | 5 |
output.aspect_ratio | string | No | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | adaptive |
output.format | string | No | mp4 | mp4 |
output.resolution | string | No | 480p, 720p, 1080p | 1080p |
prompt | string | Sí | Cadena | Ninguno |
provider_options.alibaba.prompt_extend | boolean | No | true / false; controla la ampliación del prompt | true |
seed | integer | No | 0–2147483647, incremento 1; semilla aleatoria; admite 0 | Ninguno |
watermark | boolean | No | false, true | false |
Requisitos de los recursos
Esta operación no acepta recursos.
Restricciones de combinación
duration.mode="fixed"requiereduration.seconds. Cuando indiquesfixedexplícitamente, incluye también los segundos.- Con
duration.mode="auto", no envíesduration.seconds.
Ejemplo de solicitud
Guarda el JSON siguiente como request.json y sigue el proceso general: solicita un presupuesto y confirma antes de crear la tarea.
{ "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" }}Errores 422 frecuentes
| Código de error 422 | Solución |
|---|---|
enum / range / step | Ajusta los valores y el incremento según la tabla de campos de esta sección. |
unsupported_field | Elimina los campos que no figuran en la tabla de esta operación. |
requires | Completa los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección. |
excludes | Elimina los campos que entren en conflicto con la duración automática o el fotograma final. |
wan3.0-video
Usa esta operación para generar un vídeo cuando solo tienes una descripción de texto.
Establece model en el Model ID de esta sección y operation en text_to_video. Usa solo los campos de generación de la tabla siguiente; coloca los recursos en el array media.
| Campo | Tipo | Obligatorio | Opciones o rango | Valor predeterminado |
|---|---|---|---|---|
audio.mode | string | No | on, off | on |
duration.mode | string | No | fixed, auto | fixed |
duration.seconds | integer | No | 2–30, incremento 1 s; solo con duración fija | 5 |
output.aspect_ratio | string | No | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | adaptive |
output.format | string | No | mp4 | mp4 |
output.resolution | string | No | 480p, 720p, 1080p | 1080p |
prompt | string | Sí | Cadena | Ninguno |
provider_options.alibaba.prompt_extend | boolean | No | true / false; controla la ampliación del prompt | true |
seed | integer | No | 0–2147483647, incremento 1; semilla aleatoria; admite 0 | Ninguno |
watermark | boolean | No | false, true | false |
Requisitos de los recursos
Esta operación no acepta recursos.
Restricciones de combinación
duration.mode="fixed"requiereduration.seconds. Cuando indiquesfixedexplícitamente, incluye también los segundos.- Con
duration.mode="auto", no envíesduration.seconds.
Ejemplo de solicitud
Guarda el JSON siguiente como request.json y sigue el proceso general: solicita un presupuesto y confirma antes de crear la tarea.
{ "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" }}Errores 422 frecuentes
| Código de error 422 | Solución |
|---|---|
enum / range / step | Ajusta los valores y el incremento según la tabla de campos de esta sección. |
unsupported_field | Elimina los campos que no figuran en la tabla de esta operación. |
requires | Completa los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección. |
excludes | Elimina los campos que entren en conflicto con la duración automática o el fotograma final. |
De imagen a vídeo
wan2.7-i2v
Usa esta operación para fijar el primer fotograma o el primero y el último a partir de imágenes.
Establece model en el Model ID de esta sección y operation en image_to_video. Usa solo los campos de generación de la tabla siguiente; coloca los recursos en el array media.
| Campo | Tipo | Obligatorio | Opciones o rango | Valor predeterminado |
|---|---|---|---|---|
audio.mode | string | No | provider_default | provider_default |
duration.mode | string | No | fixed | fixed |
duration.seconds | integer | No | 2–15, incremento 1 s; solo con duración fija | 5 |
output.format | string | No | mp4 | mp4 |
output.resolution | string | No | 720p, 1080p | 1080p |
prompt | string | Sí | Cadena | Ninguno |
provider_options.alibaba.prompt_extend | boolean | No | true / false; controla la ampliación del prompt | true |
seed | integer | No | 0–2147483647, incremento 1; semilla aleatoria; admite 0 | Ninguno |
watermark | boolean | No | false, true | false |
Requisitos de los recursos
| Rol del recurso | Tipo y cantidad | Formatos | Límites por archivo |
|---|---|---|---|
first_frame | image, 1 (obligatorio) | jpeg, jpg, png, bmp, webp | Tamaño máximo: 20 MB; ancho: 240–8000 px; alto: 240–8000 px |
last_frame | image, opcional, máximo 1 | jpeg, jpg, png, bmp, webp | Tamaño máximo: 20 MB; ancho: 240–8000 px; alto: 240–8000 px |
driving_audio | audio, opcional, máximo 1 | wav, mp3 | Tamaño máximo: 15 MB; duración: 2–30 s |
Los requisitos de recursos también deben cumplir las restricciones de combinación siguientes.
El recurso opcional driving_audio es audio que guía la generación y usa type="audio". Es un rol distinto de reference_audio, usado en la generación con referencias.
Restricciones de combinación
duration.mode="fixed"requiereduration.seconds. Cuando indiquesfixedexplícitamente, incluye también los segundos.- Debes proporcionar
first_frame.
Ejemplo de solicitud
Guarda el JSON siguiente como request.json y sigue el proceso general: solicita un presupuesto y confirma antes de crear la tarea.
{ "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" } ]}Errores 422 frecuentes
| Código de error 422 | Solución |
|---|---|
enum / range / step | Ajusta los valores y el incremento según la tabla de campos de esta sección. |
unsupported_field | Elimina los campos que no figuran en la tabla de esta operación. |
requires | Completa los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección. |
count / media_role | Ajusta los roles y las cantidades según la tabla de recursos de esta sección. |
video_input_unsupported | Comprueba la URL HTTPS pública, el Content-Type y el formato del archivo, y solicita otro presupuesto. |
wan3.0-video-prime
Usa esta operación para fijar el primer fotograma o el primero y el último a partir de imágenes.
Establece model en el Model ID de esta sección y operation en image_to_video. Usa solo los campos de generación de la tabla siguiente; coloca los recursos en el array media.
| Campo | Tipo | Obligatorio | Opciones o rango | Valor predeterminado |
|---|---|---|---|---|
audio.mode | string | No | on, off | on |
duration.mode | string | No | fixed, auto | fixed |
duration.seconds | integer | No | 2–30, incremento 1 s; solo con duración fija | 5 |
output.aspect_ratio | string | No | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | adaptive |
output.format | string | No | mp4 | mp4 |
output.resolution | string | No | 480p, 720p, 1080p | 1080p |
prompt | string | Sí | Cadena | Ninguno |
provider_options.alibaba.prompt_extend | boolean | No | true / false; controla la ampliación del prompt | true |
seed | integer | No | 0–2147483647, incremento 1; semilla aleatoria; admite 0 | Ninguno |
watermark | boolean | No | false, true | false |
Requisitos de los recursos
| Rol del recurso | Tipo y cantidad | Formatos | Límites por archivo |
|---|---|---|---|
first_frame | image, 1 (obligatorio) | jpeg, jpg, png, bmp, webp | Tamaño máximo: 20 MB; ancho: 240–8000 px; alto: 240–8000 px |
last_frame | image, opcional, máximo 1 | jpeg, jpg, png, bmp, webp | Tamaño máximo: 20 MB; ancho: 240–8000 px; alto: 240–8000 px |
Los requisitos de recursos también deben cumplir las restricciones de combinación siguientes.
Restricciones de combinación
duration.mode="fixed"requiereduration.seconds. Cuando indiquesfixedexplícitamente, incluye también los segundos.- Con
duration.mode="auto", no envíesduration.seconds. - Proporciona al menos uno de estos roles:
first_frame,last_frame.
Ejemplo de solicitud
Guarda el JSON siguiente como request.json y sigue el proceso general: solicita un presupuesto y confirma antes de crear la tarea.
{ "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" } ]}Errores 422 frecuentes
| Código de error 422 | Solución |
|---|---|
enum / range / step | Ajusta los valores y el incremento según la tabla de campos de esta sección. |
unsupported_field | Elimina los campos que no figuran en la tabla de esta operación. |
requires | Completa los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección. |
excludes | Elimina los campos que entren en conflicto con la duración automática o el fotograma final. |
count / media_role | Ajusta los roles y las cantidades según la tabla de recursos de esta sección. |
video_input_unsupported | Comprueba la URL HTTPS pública, el Content-Type y el formato del archivo, y solicita otro presupuesto. |
wan3.0-video
Usa esta operación para fijar el primer fotograma o el primero y el último a partir de imágenes.
Establece model en el Model ID de esta sección y operation en image_to_video. Usa solo los campos de generación de la tabla siguiente; coloca los recursos en el array media.
| Campo | Tipo | Obligatorio | Opciones o rango | Valor predeterminado |
|---|---|---|---|---|
audio.mode | string | No | on, off | on |
duration.mode | string | No | fixed, auto | fixed |
duration.seconds | integer | No | 2–30, incremento 1 s; solo con duración fija | 5 |
output.aspect_ratio | string | No | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | adaptive |
output.format | string | No | mp4 | mp4 |
output.resolution | string | No | 480p, 720p, 1080p | 1080p |
prompt | string | Sí | Cadena | Ninguno |
provider_options.alibaba.prompt_extend | boolean | No | true / false; controla la ampliación del prompt | true |
seed | integer | No | 0–2147483647, incremento 1; semilla aleatoria; admite 0 | Ninguno |
watermark | boolean | No | false, true | false |
Requisitos de los recursos
| Rol del recurso | Tipo y cantidad | Formatos | Límites por archivo |
|---|---|---|---|
first_frame | image, 1 (obligatorio) | jpeg, jpg, png, bmp, webp | Tamaño máximo: 20 MB; ancho: 240–8000 px; alto: 240–8000 px |
last_frame | image, opcional, máximo 1 | jpeg, jpg, png, bmp, webp | Tamaño máximo: 20 MB; ancho: 240–8000 px; alto: 240–8000 px |
Los requisitos de recursos también deben cumplir las restricciones de combinación siguientes.
Restricciones de combinación
duration.mode="fixed"requiereduration.seconds. Cuando indiquesfixedexplícitamente, incluye también los segundos.- Con
duration.mode="auto", no envíesduration.seconds. - Proporciona al menos uno de estos roles:
first_frame,last_frame.
Ejemplo de solicitud
Guarda el JSON siguiente como request.json y sigue el proceso general: solicita un presupuesto y confirma antes de crear la tarea.
{ "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" } ]}Errores 422 frecuentes
| Código de error 422 | Solución |
|---|---|
enum / range / step | Ajusta los valores y el incremento según la tabla de campos de esta sección. |
unsupported_field | Elimina los campos que no figuran en la tabla de esta operación. |
requires | Completa los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección. |
excludes | Elimina los campos que entren en conflicto con la duración automática o el fotograma final. |
count / media_role | Ajusta los roles y las cantidades según la tabla de recursos de esta sección. |
video_input_unsupported | Comprueba la URL HTTPS pública, el Content-Type y el formato del archivo, y solicita otro presupuesto. |
Generación con referencias
wan2.7-r2v
Usa esta operación para conservar las características del sujeto o del movimiento mediante recursos de referencia.
Establece model en el Model ID de esta sección y operation en reference_to_video. Usa solo los campos de generación de la tabla siguiente; coloca los recursos en el array media.
| Campo | Tipo | Obligatorio | Opciones o rango | Valor predeterminado |
|---|---|---|---|---|
audio.mode | string | No | provider_default | provider_default |
duration.mode | string | No | fixed | fixed |
duration.seconds | integer | No | 2–15, incremento 1 s; solo con duración fija | 5 |
output.aspect_ratio | string | No | 16:9, 9:16, 1:1, 4:3, 3:4 | 16:9 |
output.format | string | No | mp4 | mp4 |
output.resolution | string | No | 720p, 1080p | 1080p |
prompt | string | Sí | Cadena | Ninguno |
provider_options.alibaba.prompt_extend | boolean | No | true / false; controla la ampliación del prompt | true |
seed | integer | No | 0–2147483647, incremento 1; semilla aleatoria; admite 0 | Ninguno |
watermark | boolean | No | false, true | false |
Requisitos de los recursos
| Rol del recurso | Tipo y cantidad | Formatos | Límites por archivo |
|---|---|---|---|
reference_image | image, opcional, máximo 10 | jpeg, jpg, png, bmp, webp | Tamaño máximo: 20 MB; ancho: 240–8000 px; alto: 240–8000 px |
reference_video | video, opcional, máximo 5 | mp4, mov | Tamaño máximo: 100 MB; ancho: 240–4096 px; alto: 240–4096 px; duración: 1–15 s; velocidad de fotogramas mínima: 16 fps; duración total máxima de este rol: 15 s |
Los requisitos de recursos también deben cumplir las restricciones de combinación siguientes.
Restricciones de combinación
duration.mode="fixed"requiereduration.seconds. Cuando indiquesfixedexplícitamente, incluye también los segundos.- Proporciona al menos uno de estos roles:
reference_image,reference_video.
Ejemplo de solicitud
Guarda el JSON siguiente como request.json y sigue el proceso general: solicita un presupuesto y confirma antes de crear la tarea.
{ "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" } ]}Errores 422 frecuentes
| Código de error 422 | Solución |
|---|---|
enum / range / step | Ajusta los valores y el incremento según la tabla de campos de esta sección. |
unsupported_field | Elimina los campos que no figuran en la tabla de esta operación. |
requires | Completa los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección. |
count / media_role | Ajusta los roles y las cantidades según la tabla de recursos de esta sección. |
video_input_unsupported | Comprueba la URL HTTPS pública, el Content-Type y el formato del archivo, y solicita otro presupuesto. |
wan3.0-video-prime
Usa esta operación para conservar las características del sujeto o del movimiento mediante recursos de referencia.
Establece model en el Model ID de esta sección y operation en reference_to_video. Usa solo los campos de generación de la tabla siguiente; coloca los recursos en el array media.
| Campo | Tipo | Obligatorio | Opciones o rango | Valor predeterminado |
|---|---|---|---|---|
audio.mode | string | No | on, off | on |
duration.mode | string | No | fixed, auto | fixed |
duration.seconds | integer | No | 2–30, incremento 1 s; solo con duración fija | 5 |
output.aspect_ratio | string | No | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | adaptive |
output.format | string | No | mp4 | mp4 |
output.resolution | string | No | 480p, 720p, 1080p | 1080p |
prompt | string | Sí | Cadena | Ninguno |
provider_options.alibaba.prompt_extend | boolean | No | true / false; controla la ampliación del prompt | true |
seed | integer | No | 0–2147483647, incremento 1; semilla aleatoria; admite 0 | Ninguno |
watermark | boolean | No | false, true | false |
Requisitos de los recursos
| Rol del recurso | Tipo y cantidad | Formatos | Límites por archivo |
|---|---|---|---|
reference_image | image, opcional, máximo 10 | jpeg, jpg, png, bmp, webp | Tamaño máximo: 20 MB; ancho: 240–8000 px; alto: 240–8000 px |
reference_video | video, opcional, máximo 5 | mp4, mov | Tamaño máximo: 100 MB; ancho: 240–4096 px; alto: 240–4096 px; duración: 1–15 s; velocidad de fotogramas mínima: 16 fps; duración total máxima de este rol: 15 s |
reference_audio | audio, opcional, máximo 5 | wav, mp3 | Tamaño máximo: 15 MB; duración: 1–15 s; duración total máxima de este rol: 15 s |
Los requisitos de recursos también deben cumplir las restricciones de combinación siguientes.
Restricciones de combinación
duration.mode="fixed"requiereduration.seconds. Cuando indiquesfixedexplícitamente, incluye también los segundos.- Con
duration.mode="auto", no envíesduration.seconds. - Proporciona al menos uno de estos roles:
reference_image,reference_video,reference_audio. - Con vídeos de referencia, la suma de su duración total y la duración de salida no puede superar 30 segundos. Con duración automática, el límite de salida también depende del tiempo restante.
Ejemplo de solicitud
Guarda el JSON siguiente como request.json y sigue el proceso general: solicita un presupuesto y confirma antes de crear la tarea.
{ "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" } ]}Errores 422 frecuentes
| Código de error 422 | Solución |
|---|---|
enum / range / step | Ajusta los valores y el incremento según la tabla de campos de esta sección. |
unsupported_field | Elimina los campos que no figuran en la tabla de esta operación. |
requires | Completa los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección. |
excludes | Elimina los campos que entren en conflicto con la duración automática o el fotograma final. |
sum_lte | Reduce la duración total de los vídeos de referencia o la duración de salida para que la suma no supere 30 segundos. |
count / media_role | Ajusta los roles y las cantidades según la tabla de recursos de esta sección. |
video_input_unsupported | Comprueba la URL HTTPS pública, el Content-Type y el formato del archivo, y solicita otro presupuesto. |
wan3.0-video
Usa esta operación para conservar las características del sujeto o del movimiento mediante recursos de referencia.
Establece model en el Model ID de esta sección y operation en reference_to_video. Usa solo los campos de generación de la tabla siguiente; coloca los recursos en el array media.
| Campo | Tipo | Obligatorio | Opciones o rango | Valor predeterminado |
|---|---|---|---|---|
audio.mode | string | No | on, off | on |
duration.mode | string | No | fixed, auto | fixed |
duration.seconds | integer | No | 2–30, incremento 1 s; solo con duración fija | 5 |
output.aspect_ratio | string | No | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | adaptive |
output.format | string | No | mp4 | mp4 |
output.resolution | string | No | 480p, 720p, 1080p | 1080p |
prompt | string | Sí | Cadena | Ninguno |
provider_options.alibaba.prompt_extend | boolean | No | true / false; controla la ampliación del prompt | true |
seed | integer | No | 0–2147483647, incremento 1; semilla aleatoria; admite 0 | Ninguno |
watermark | boolean | No | false, true | false |
Requisitos de los recursos
| Rol del recurso | Tipo y cantidad | Formatos | Límites por archivo |
|---|---|---|---|
reference_image | image, opcional, máximo 10 | jpeg, jpg, png, bmp, webp | Tamaño máximo: 20 MB; ancho: 240–8000 px; alto: 240–8000 px |
reference_video | video, opcional, máximo 5 | mp4, mov | Tamaño máximo: 100 MB; ancho: 240–4096 px; alto: 240–4096 px; duración: 1–15 s; velocidad de fotogramas mínima: 16 fps; duración total máxima de este rol: 15 s |
reference_audio | audio, opcional, máximo 5 | wav, mp3 | Tamaño máximo: 15 MB; duración: 1–15 s; duración total máxima de este rol: 15 s |
Los requisitos de recursos también deben cumplir las restricciones de combinación siguientes.
Restricciones de combinación
duration.mode="fixed"requiereduration.seconds. Cuando indiquesfixedexplícitamente, incluye también los segundos.- Con
duration.mode="auto", no envíesduration.seconds. - Proporciona al menos uno de estos roles:
reference_image,reference_video,reference_audio. - Con vídeos de referencia, la suma de su duración total y la duración de salida no puede superar 30 segundos. Con duración automática, el límite de salida también depende del tiempo restante.
Ejemplo de solicitud
Guarda el JSON siguiente como request.json y sigue el proceso general: solicita un presupuesto y confirma antes de crear la tarea.
{ "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" } ]}Errores 422 frecuentes
| Código de error 422 | Solución |
|---|---|
enum / range / step | Ajusta los valores y el incremento según la tabla de campos de esta sección. |
unsupported_field | Elimina los campos que no figuran en la tabla de esta operación. |
requires | Completa los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección. |
excludes | Elimina los campos que entren en conflicto con la duración automática o el fotograma final. |
sum_lte | Reduce la duración total de los vídeos de referencia o la duración de salida para que la suma no supere 30 segundos. |
count / media_role | Ajusta los roles y las cantidades según la tabla de recursos de esta sección. |
video_input_unsupported | Comprueba la URL HTTPS pública, el Content-Type y el formato del archivo, y solicita otro presupuesto. |
Edición de vídeo
wan2.7-videoedit
Usa esta operación para modificar las imágenes de un vídeo existente. Prepara primero un vídeo de origen que cumpla los límites.
Establece model en el Model ID de esta sección y operation en video_edit. Usa solo los campos de generación de la tabla siguiente; coloca los recursos en el array media.
| Campo | Tipo | Obligatorio | Opciones o rango | Valor predeterminado |
|---|---|---|---|---|
audio.mode | string | No | provider_default | provider_default |
duration.mode | string | No | fixed, auto | auto |
duration.seconds | integer | No | 2–15, incremento 1 s; solo con duración fija | Ninguno |
output.format | string | No | mp4 | mp4 |
output.resolution | string | No | 720p, 1080p | 1080p |
prompt | string | Sí | Cadena | Ninguno |
provider_options.alibaba.prompt_extend | boolean | No | true / false; controla la ampliación del prompt | true |
seed | integer | No | 0–2147483647, incremento 1; semilla aleatoria; admite 0 | Ninguno |
watermark | boolean | No | false, true | false |
Requisitos de los recursos
| Rol del recurso | Tipo y cantidad | Formatos | Límites por archivo |
|---|---|---|---|
base_video | video, 1 (obligatorio) | mp4, mov | Tamaño máximo: 100 MB; ancho: 240–4096 px; alto: 240–4096 px; duración: 1–15 s; velocidad de fotogramas mínima: 16 fps; duración total máxima de este rol: 15 s |
Los requisitos de recursos también deben cumplir las restricciones de combinación siguientes.
Restricciones de combinación
duration.mode="fixed"requiereduration.seconds. Cuando indiquesfixedexplícitamente, incluye también los segundos.- Debes proporcionar
base_video. - Con
duration.mode="auto", no envíesduration.seconds.
Ejemplo de solicitud
Guarda el JSON siguiente como request.json y sigue el proceso general: solicita un presupuesto y confirma antes de crear la tarea.
{ "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" } ]}Errores 422 frecuentes
| Código de error 422 | Solución |
|---|---|
enum / range / step | Ajusta los valores y el incremento según la tabla de campos de esta sección. |
unsupported_field | Elimina los campos que no figuran en la tabla de esta operación. |
requires | Completa los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección. |
excludes | Elimina los campos que entren en conflicto con la duración automática o el fotograma final. |
count / media_role | Ajusta los roles y las cantidades según la tabla de recursos de esta sección. |
video_input_unsupported | Comprueba la URL HTTPS pública, el Content-Type y el formato del archivo, y solicita otro presupuesto. |
Documentación oficial
Al llamar a BetterToken, usa los campos de esta página y la operación correspondiente del catálogo de modelos en tiempo real.

