Ir al contenido
Regístrate gratis
Wan

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 IDOperaciónDuración (segundos)Nivel de salidaRelación de aspectoAudioRoles de recursos
wan2.7-i2vimage_to_video2–15, incremento 1720p, 1080pNo enviarprovider_defaultfirst_frame, last_frame, driving_audio
wan2.7-r2vreference_to_video2–15, incremento 1720p, 1080p16:9, 9:16, 1:1, 4:3, 3:4provider_defaultreference_image, reference_video
wan2.7-t2vtext_to_video2–15, incremento 1720p, 1080p16:9, 9:16, 1:1, 4:3, 3:4provider_defaultdriving_audio
wan2.7-videoeditvideo_edit2–15, incremento 1; admite auto720p, 1080pNo enviarprovider_defaultbase_video
wan3.0-video-primeimage_to_video2–30, incremento 1; admite 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, incremento 1; admite 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, incremento 1; admite auto480p, 720p, 1080padaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16on, offNinguno
wan3.0-videoimage_to_video2–30, incremento 1; admite 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, incremento 1; admite 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, incremento 1; admite auto480p, 720p, 1080padaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16on, offNinguno

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.

Imagen de referencia para generar vídeo: taza de cerámica azul sobre una mesa blanca

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.

CampoTipoObligatorioOpciones o rangoValor predeterminado
audio.modestringNoprovider_defaultprovider_default
duration.modestringNofixedfixed
duration.secondsintegerNo2–15, incremento 1 s; solo con duración fija5
output.aspect_ratiostringNo16:9, 9:16, 1:1, 4:3, 3:416:9
output.formatstringNomp4mp4
output.resolutionstringNo720p, 1080p1080p
promptstringSíCadenaNinguno
provider_options.alibaba.prompt_extendbooleanNotrue / false; controla la ampliación del prompttrue
seedintegerNo0–2147483647, incremento 1; semilla aleatoria; admite 0Ninguno
watermarkbooleanNofalse, truefalse

Requisitos de los recursos

Rol del recursoTipo y cantidadFormatosLímites por archivo
driving_audioaudio, opcional, máximo 1wav, mp3Tamañ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" requiere duration.seconds. Cuando indiques fixed explí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 422Solución
enum / range / stepAjusta los valores y el incremento según la tabla de campos de esta sección.
unsupported_fieldElimina los campos que no figuran en la tabla de esta operación.
requiresCompleta los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección.
count / media_roleAjusta los roles y las cantidades según la tabla de recursos de esta sección.
video_input_unsupportedComprueba 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.

CampoTipoObligatorioOpciones o rangoValor predeterminado
audio.modestringNoon, offon
duration.modestringNofixed, autofixed
duration.secondsintegerNo2–30, incremento 1 s; solo con duración fija5
output.aspect_ratiostringNoadaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16adaptive
output.formatstringNomp4mp4
output.resolutionstringNo480p, 720p, 1080p1080p
promptstringSíCadenaNinguno
provider_options.alibaba.prompt_extendbooleanNotrue / false; controla la ampliación del prompttrue
seedintegerNo0–2147483647, incremento 1; semilla aleatoria; admite 0Ninguno
watermarkbooleanNofalse, truefalse

Requisitos de los recursos

Esta operación no acepta recursos.

Restricciones de combinación

  • duration.mode="fixed" requiere duration.seconds. Cuando indiques fixed explícitamente, incluye también los segundos.
  • Con duration.mode="auto", no envíes duration.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 422Solución
enum / range / stepAjusta los valores y el incremento según la tabla de campos de esta sección.
unsupported_fieldElimina los campos que no figuran en la tabla de esta operación.
requiresCompleta los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección.
excludesElimina 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.

CampoTipoObligatorioOpciones o rangoValor predeterminado
audio.modestringNoon, offon
duration.modestringNofixed, autofixed
duration.secondsintegerNo2–30, incremento 1 s; solo con duración fija5
output.aspect_ratiostringNoadaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16adaptive
output.formatstringNomp4mp4
output.resolutionstringNo480p, 720p, 1080p1080p
promptstringSíCadenaNinguno
provider_options.alibaba.prompt_extendbooleanNotrue / false; controla la ampliación del prompttrue
seedintegerNo0–2147483647, incremento 1; semilla aleatoria; admite 0Ninguno
watermarkbooleanNofalse, truefalse

Requisitos de los recursos

Esta operación no acepta recursos.

Restricciones de combinación

  • duration.mode="fixed" requiere duration.seconds. Cuando indiques fixed explícitamente, incluye también los segundos.
  • Con duration.mode="auto", no envíes duration.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 422Solución
enum / range / stepAjusta los valores y el incremento según la tabla de campos de esta sección.
unsupported_fieldElimina los campos que no figuran en la tabla de esta operación.
requiresCompleta los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección.
excludesElimina 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.

CampoTipoObligatorioOpciones o rangoValor predeterminado
audio.modestringNoprovider_defaultprovider_default
duration.modestringNofixedfixed
duration.secondsintegerNo2–15, incremento 1 s; solo con duración fija5
output.formatstringNomp4mp4
output.resolutionstringNo720p, 1080p1080p
promptstringSíCadenaNinguno
provider_options.alibaba.prompt_extendbooleanNotrue / false; controla la ampliación del prompttrue
seedintegerNo0–2147483647, incremento 1; semilla aleatoria; admite 0Ninguno
watermarkbooleanNofalse, truefalse

Requisitos de los recursos

Rol del recursoTipo y cantidadFormatosLímites por archivo
first_frameimage, 1 (obligatorio)jpeg, jpg, png, bmp, webpTamaño máximo: 20 MB; ancho: 240–8000 px; alto: 240–8000 px
last_frameimage, opcional, máximo 1jpeg, jpg, png, bmp, webpTamaño máximo: 20 MB; ancho: 240–8000 px; alto: 240–8000 px
driving_audioaudio, opcional, máximo 1wav, mp3Tamañ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" requiere duration.seconds. Cuando indiques fixed explí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 422Solución
enum / range / stepAjusta los valores y el incremento según la tabla de campos de esta sección.
unsupported_fieldElimina los campos que no figuran en la tabla de esta operación.
requiresCompleta los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección.
count / media_roleAjusta los roles y las cantidades según la tabla de recursos de esta sección.
video_input_unsupportedComprueba 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.

CampoTipoObligatorioOpciones o rangoValor predeterminado
audio.modestringNoon, offon
duration.modestringNofixed, autofixed
duration.secondsintegerNo2–30, incremento 1 s; solo con duración fija5
output.aspect_ratiostringNoadaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16adaptive
output.formatstringNomp4mp4
output.resolutionstringNo480p, 720p, 1080p1080p
promptstringSíCadenaNinguno
provider_options.alibaba.prompt_extendbooleanNotrue / false; controla la ampliación del prompttrue
seedintegerNo0–2147483647, incremento 1; semilla aleatoria; admite 0Ninguno
watermarkbooleanNofalse, truefalse

Requisitos de los recursos

Rol del recursoTipo y cantidadFormatosLímites por archivo
first_frameimage, 1 (obligatorio)jpeg, jpg, png, bmp, webpTamaño máximo: 20 MB; ancho: 240–8000 px; alto: 240–8000 px
last_frameimage, opcional, máximo 1jpeg, jpg, png, bmp, webpTamañ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" requiere duration.seconds. Cuando indiques fixed explícitamente, incluye también los segundos.
  • Con duration.mode="auto", no envíes duration.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 422Solución
enum / range / stepAjusta los valores y el incremento según la tabla de campos de esta sección.
unsupported_fieldElimina los campos que no figuran en la tabla de esta operación.
requiresCompleta los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección.
excludesElimina los campos que entren en conflicto con la duración automática o el fotograma final.
count / media_roleAjusta los roles y las cantidades según la tabla de recursos de esta sección.
video_input_unsupportedComprueba 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.

CampoTipoObligatorioOpciones o rangoValor predeterminado
audio.modestringNoon, offon
duration.modestringNofixed, autofixed
duration.secondsintegerNo2–30, incremento 1 s; solo con duración fija5
output.aspect_ratiostringNoadaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16adaptive
output.formatstringNomp4mp4
output.resolutionstringNo480p, 720p, 1080p1080p
promptstringSíCadenaNinguno
provider_options.alibaba.prompt_extendbooleanNotrue / false; controla la ampliación del prompttrue
seedintegerNo0–2147483647, incremento 1; semilla aleatoria; admite 0Ninguno
watermarkbooleanNofalse, truefalse

Requisitos de los recursos

Rol del recursoTipo y cantidadFormatosLímites por archivo
first_frameimage, 1 (obligatorio)jpeg, jpg, png, bmp, webpTamaño máximo: 20 MB; ancho: 240–8000 px; alto: 240–8000 px
last_frameimage, opcional, máximo 1jpeg, jpg, png, bmp, webpTamañ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" requiere duration.seconds. Cuando indiques fixed explícitamente, incluye también los segundos.
  • Con duration.mode="auto", no envíes duration.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 422Solución
enum / range / stepAjusta los valores y el incremento según la tabla de campos de esta sección.
unsupported_fieldElimina los campos que no figuran en la tabla de esta operación.
requiresCompleta los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección.
excludesElimina los campos que entren en conflicto con la duración automática o el fotograma final.
count / media_roleAjusta los roles y las cantidades según la tabla de recursos de esta sección.
video_input_unsupportedComprueba 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.

CampoTipoObligatorioOpciones o rangoValor predeterminado
audio.modestringNoprovider_defaultprovider_default
duration.modestringNofixedfixed
duration.secondsintegerNo2–15, incremento 1 s; solo con duración fija5
output.aspect_ratiostringNo16:9, 9:16, 1:1, 4:3, 3:416:9
output.formatstringNomp4mp4
output.resolutionstringNo720p, 1080p1080p
promptstringSíCadenaNinguno
provider_options.alibaba.prompt_extendbooleanNotrue / false; controla la ampliación del prompttrue
seedintegerNo0–2147483647, incremento 1; semilla aleatoria; admite 0Ninguno
watermarkbooleanNofalse, truefalse

Requisitos de los recursos

Rol del recursoTipo y cantidadFormatosLímites por archivo
reference_imageimage, opcional, máximo 10jpeg, jpg, png, bmp, webpTamaño máximo: 20 MB; ancho: 240–8000 px; alto: 240–8000 px
reference_videovideo, opcional, máximo 5mp4, movTamañ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" requiere duration.seconds. Cuando indiques fixed explí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 422Solución
enum / range / stepAjusta los valores y el incremento según la tabla de campos de esta sección.
unsupported_fieldElimina los campos que no figuran en la tabla de esta operación.
requiresCompleta los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección.
count / media_roleAjusta los roles y las cantidades según la tabla de recursos de esta sección.
video_input_unsupportedComprueba 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.

CampoTipoObligatorioOpciones o rangoValor predeterminado
audio.modestringNoon, offon
duration.modestringNofixed, autofixed
duration.secondsintegerNo2–30, incremento 1 s; solo con duración fija5
output.aspect_ratiostringNoadaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16adaptive
output.formatstringNomp4mp4
output.resolutionstringNo480p, 720p, 1080p1080p
promptstringSíCadenaNinguno
provider_options.alibaba.prompt_extendbooleanNotrue / false; controla la ampliación del prompttrue
seedintegerNo0–2147483647, incremento 1; semilla aleatoria; admite 0Ninguno
watermarkbooleanNofalse, truefalse

Requisitos de los recursos

Rol del recursoTipo y cantidadFormatosLímites por archivo
reference_imageimage, opcional, máximo 10jpeg, jpg, png, bmp, webpTamaño máximo: 20 MB; ancho: 240–8000 px; alto: 240–8000 px
reference_videovideo, opcional, máximo 5mp4, movTamañ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_audioaudio, opcional, máximo 5wav, mp3Tamañ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" requiere duration.seconds. Cuando indiques fixed explícitamente, incluye también los segundos.
  • Con duration.mode="auto", no envíes duration.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 422Solución
enum / range / stepAjusta los valores y el incremento según la tabla de campos de esta sección.
unsupported_fieldElimina los campos que no figuran en la tabla de esta operación.
requiresCompleta los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección.
excludesElimina los campos que entren en conflicto con la duración automática o el fotograma final.
sum_lteReduce 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_roleAjusta los roles y las cantidades según la tabla de recursos de esta sección.
video_input_unsupportedComprueba 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.

CampoTipoObligatorioOpciones o rangoValor predeterminado
audio.modestringNoon, offon
duration.modestringNofixed, autofixed
duration.secondsintegerNo2–30, incremento 1 s; solo con duración fija5
output.aspect_ratiostringNoadaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16adaptive
output.formatstringNomp4mp4
output.resolutionstringNo480p, 720p, 1080p1080p
promptstringSíCadenaNinguno
provider_options.alibaba.prompt_extendbooleanNotrue / false; controla la ampliación del prompttrue
seedintegerNo0–2147483647, incremento 1; semilla aleatoria; admite 0Ninguno
watermarkbooleanNofalse, truefalse

Requisitos de los recursos

Rol del recursoTipo y cantidadFormatosLímites por archivo
reference_imageimage, opcional, máximo 10jpeg, jpg, png, bmp, webpTamaño máximo: 20 MB; ancho: 240–8000 px; alto: 240–8000 px
reference_videovideo, opcional, máximo 5mp4, movTamañ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_audioaudio, opcional, máximo 5wav, mp3Tamañ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" requiere duration.seconds. Cuando indiques fixed explícitamente, incluye también los segundos.
  • Con duration.mode="auto", no envíes duration.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 422Solución
enum / range / stepAjusta los valores y el incremento según la tabla de campos de esta sección.
unsupported_fieldElimina los campos que no figuran en la tabla de esta operación.
requiresCompleta los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección.
excludesElimina los campos que entren en conflicto con la duración automática o el fotograma final.
sum_lteReduce 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_roleAjusta los roles y las cantidades según la tabla de recursos de esta sección.
video_input_unsupportedComprueba 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.

CampoTipoObligatorioOpciones o rangoValor predeterminado
audio.modestringNoprovider_defaultprovider_default
duration.modestringNofixed, autoauto
duration.secondsintegerNo2–15, incremento 1 s; solo con duración fijaNinguno
output.formatstringNomp4mp4
output.resolutionstringNo720p, 1080p1080p
promptstringSíCadenaNinguno
provider_options.alibaba.prompt_extendbooleanNotrue / false; controla la ampliación del prompttrue
seedintegerNo0–2147483647, incremento 1; semilla aleatoria; admite 0Ninguno
watermarkbooleanNofalse, truefalse

Requisitos de los recursos

Rol del recursoTipo y cantidadFormatosLímites por archivo
base_videovideo, 1 (obligatorio)mp4, movTamañ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" requiere duration.seconds. Cuando indiques fixed explícitamente, incluye también los segundos.
  • Debes proporcionar base_video.
  • Con duration.mode="auto", no envíes duration.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 422Solución
enum / range / stepAjusta los valores y el incremento según la tabla de campos de esta sección.
unsupported_fieldElimina los campos que no figuran en la tabla de esta operación.
requiresCompleta los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección.
excludesElimina los campos que entren en conflicto con la duración automática o el fotograma final.
count / media_roleAjusta los roles y las cantidades según la tabla de recursos de esta sección.
video_input_unsupportedComprueba 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.