API de Video Wan 3.0
Parámetros, combinaciones de medios, tareas asíncronas, descargas y facturación por segundo para wan3.0-video en APIMaster.
API de Video Wan 3.0
wan3.0-video es el modelo estándar Wan 3; es un modelo separado de wan3.0-video-prime. Admite texto, imágenes, video, audio, documentos y páginas web públicas. Cada tarea exitosa produce un video MP4/H.264, de hasta 30 segundos. Integración revisada: 2026-11-17.
Cada solicitud admite 20 elementos multimedia en total como máximo. El vídeo generado utiliza 30 fps.
Puntos finales y autenticación
| Operación | Punto final |
|---|---|
| Crear | POST https://apimaster.ai/v1/videos |
| Consultar | GET https://apimaster.ai/v1/videos/{task_id} |
| Descargar | GET https://apimaster.ai/v1/videos/{task_id}/content |
Authorization: Bearer YOUR_API_KEY · Content-Type: application/json
Todos los parámetros de la solicitud
Usa un formato de medios por solicitud. Usa metadata.input.media para combinar medios de referencia o incluir documentos.
| Parámetro | Tipo | Obligatorio / predeterminado | Significado y valores válidos |
|---|---|---|---|
model |
string | Obligatorio | Exactamente wan3.0-video; no sustituya Prime |
prompt |
string | Obligatorio | Describa el resultado en chino o inglés; el límite oficial es de 20,000 caracteres, el texto nativo más largo se trunca. Consulte Image 1, Video 1, Audio 1 en el orden de los medios; cada tipo de medio tiene su propia numeración |
duration |
integer | 5 |
2–30 segundos de salida; -1 permite que el modelo seleccione la duración. Con video de referencia, la duración de entrada más la de salida no puede superar los 30 segundos |
seconds |
string | Opcional | Alias de duración, p. ej. "5" o "-1"; debe coincidir con duration cuando se proporcionan ambos |
resolution |
string | 1080P |
480P, 720P, 1080P; los valores de nivel superior en minúsculas se normalizan |
aspect_ratio |
string | adaptive |
adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 |
ratio |
string | Opcional | Alias de aspect_ratio; se recomienda adaptive para la extensión de video |
size |
string | Opcional | Alias de compatibilidad: nivel de resolución, o una asignación de píxeles compatible como 1280x720; prefiera resolución y proporción explícitas, no tamaños de píxeles arbitrarios |
generate_audio |
boolean | true en el origen |
Si la salida tiene una pista de audio. El valor false explícito se conserva. El audio no cambia la tarifa por segundo |
audio |
boolean | Opcional | Alias de generate_audio; use un solo interruptor de audio |
prompt_extend |
boolean | true |
Reescritura inteligente del prompt; el valor false explícito se conserva. Debe ser true para entrada de documento/página |
watermark |
boolean | false en el origen |
Agrega una marca de agua a la salida; el valor false explícito se conserva |
seed |
integer | Aleatorio | -1 o 0–2147483647. La omisión o -1 solicita una semilla aleatoria; 0 se reenvía. Las semillas repetidas no garantizan una salida idéntica |
input_reference |
string | Opcional | URL de la imagen del primer fotograma; reemplaza la matriz nativa de medios. No mezcle estilos de entrada |
images |
string[] | Opcional | Matriz de conveniencia que se añade como elementos reference_image cuando input_reference está ausente |
metadata |
object | Opcional | Contenedor para los objetos nativos siguientes; no puede cambiar el modelo seleccionado |
metadata.input |
object | Opcional | Objeto de entrada nativo |
metadata.input.prompt |
string | Opcional | Anulación del prompt nativo; conserve el prompt de nivel superior obligatorio |
metadata.input.media |
object[] | Opcional | Matriz de medios ordenada. Cada elemento requiere type y url; consulte los límites a continuación |
metadata.input.media[].type |
string | Obligatorio por elemento | first_frame, last_frame, reference_image, reference_video, reference_audio, file, link |
metadata.input.media[].url |
string | Obligatorio por elemento | URL pública de medios HTTP(S); los tipos de imagen también aceptan una cadena data:{MIME_type};base64,.... Los medios que no son imágenes requieren una URL pública |
metadata.parameters |
object | Opcional | Objeto de parámetros nativo; no puede ser null |
metadata.parameters.resolution |
string | 1080P |
480P, 720P, 1080P en mayúsculas |
metadata.parameters.ratio |
string | adaptive |
Los mismos valores de proporción de aspecto enumerados arriba |
metadata.parameters.duration |
integer | 5 |
2–30, o -1; la misma restricción de duración combinada |
metadata.parameters.audio |
boolean | true en el origen |
El mismo interruptor de audio de salida |
metadata.parameters.prompt_extend |
boolean | true |
El mismo interruptor de reescritura del prompt; file/link requiere true |
metadata.parameters.watermark |
boolean | false en el origen |
El mismo interruptor de marca de agua |
metadata.parameters.seed |
integer | Aleatorio | El mismo rango de semillas, incluido 0 explícito |
Los campos nativos negative_prompt, img_url, first_frame_url, last_frame_url y audio_url no son controles de medios de Wan 3. Utilice la matriz de medios documentada en su lugar.
Límites de medios y combinaciones válidas
| Tipo de medio | Cantidad y restricciones |
|---|---|
first_frame, last_frame |
Como máximo uno de cada uno. El último fotograma requiere el primer fotograma. Los controles de fotogramas no pueden combinarse con ningún tipo de referencia, archivo o enlace |
reference_image |
Como máximo 10. JPEG/JPG, PNG sin transparencia, BMP o WEBP; cada lado 240–8,000 píxeles, relación de aspecto como máximo 8:1, cada archivo como máximo 20 MB |
reference_video |
Como máximo 5 clips MP4/MOV; cada uno de 1–15 segundos, entrada combinada como máximo 15 segundos; al menos 16 fps; cada lado 240–4,096 píxeles, relación de aspecto como máximo 8:1, cada archivo como máximo 100 MB |
reference_audio |
Como máximo 5 clips WAV/MP3; cada uno de 1–15 segundos, combinados como máximo 15 segundos; cada archivo como máximo 15 MB |
file |
Como máximo un archivo DOCX/DOC/XLSX/XLS/PPTX/PPT/PDF/TXT/KEY/PAGES/NUMBERS/MD; como máximo 100 MB. Los documentos paginados PDF, DOCX, DOC, PPTX, PPT y KEY/PAGES tienen un límite de 50 páginas |
link |
Como máximo una página de acceso público sin inicio de sesión; no combinar con file |
Las imágenes, el video y el audio de referencia pueden combinarse. Un archivo o enlace puede acompañar a los medios de referencia. El modo de primer/último fotograma solo acepta controles de fotogramas; use el modo de imagen de referencia más audio de referencia para la generación impulsada por audio. El análisis de medios y la moderación de contenido siguen sujetos a verificaciones upstream.
Texto a video usa un prompt sin medios. La animación de primer fotograma usa first_frame; las transiciones usan first_frame más last_frame. La generación por referencia usa los tipos de referencia. Para edición o extensión, proporcione reference_video y describa la edición o extensión en el prompt; use adaptive para la extensión.
Ejemplos
Texto a video
curl "https://apimaster.ai/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"wan3.0-video","prompt":"A paper boat drifting on a quiet pond, static camera.","duration":2,"resolution":"480P","aspect_ratio":"16:9","generate_audio":false,"prompt_extend":false,"watermark":false,"seed":0}'
Primer y último fotograma
{"model":"wan3.0-video","prompt":"Move smoothly from the first frame to the last.","duration":5,"resolution":"720P","metadata":{"input":{"media":[{"type":"first_frame","url":"https://example.com/start.png"},{"type":"last_frame","url":"https://example.com/end.png"}]}}}
Imagen y audio de referencia
{"model":"wan3.0-video","prompt":"Animate Image 1 to the rhythm of Audio 1.","duration":5,"resolution":"720P","metadata":{"input":{"media":[{"type":"reference_image","url":"https://example.com/character.png"},{"type":"reference_audio","url":"https://example.com/music.mp3"}]}}}
Edición / extensión de video y duración inteligente
{"model":"wan3.0-video","prompt":"Extend Video 1 forward as the camera follows the paper boat.","duration":-1,"resolution":"480P","aspect_ratio":"adaptive","metadata":{"input":{"media":[{"type":"reference_video","url":"https://example.com/input.mp4"}]}}}
Documento / página web
{"model":"wan3.0-video","prompt":"Create a product introduction based on this document.","duration":10,"resolution":"720P","prompt_extend":true,"metadata":{"input":{"media":[{"type":"file","url":"https://example.com/product.pdf"}]}}}
Reemplace todas las URL de ejemplo con medios públicos reales. Para la entrada web, reemplace el elemento file por {"type":"link","url":"https://example.com/product"}. El ejemplo del primer fotograma también funciona sin su elemento de último fotograma.
Respuestas, sondeo, descargas y registros
La creación devuelve un ID de tarea de APIMaster, no el ID del proveedor de origen:
{"id":"task_example","task_id":"task_example","object":"video","model":"wan3.0-video","status":"queued"}
| Campo de respuesta | Significado |
|---|---|
id / task_id |
Identificador de tarea de la plataforma usado por la consulta y la descarga |
status |
queued, in_progress, completed, failed |
progress |
Indicador de progreso; espere el estado terminal |
error.code, error.message |
Información de error cuando corresponda |
metadata.url |
Ubicación del contenido cuando se devuelve al completarse |
Realice el sondeo aproximadamente cada 15 segundos usando la misma clave de API. No cree otra tarea para comprobar el progreso. Los IDs de tarea y las URL de salida del proveedor nativo caducan después de 24 horas; descargue y conserve los resultados exitosos de inmediato. Se prefiere el endpoint de contenido autenticado de APIMaster en lugar de almacenar URL temporales del proveedor de origen.
curl "https://apimaster.ai/v1/videos/task_example" -H "Authorization: Bearer YOUR_API_KEY"
curl -L "https://apimaster.ai/v1/videos/task_example/content" \
-H "Authorization: Bearer YOUR_API_KEY" -o wan3.mp4
El registro de uso contiene la tarea y el resultado exitoso del video. Verifique el cargo final después de completarse; la aceptación no es prueba de que la generación haya sido exitosa. El sondeo repetido no genera otro cargo por generación.
Facturación
Consulta las tarifas por segundo en la ficha del modelo.
APIMaster suma la duración de todos los vídeos de entrada y la del vídeo de salida, redondea el total una sola vez al segundo superior y lo multiplica por la tarifa por segundo de la resolución de salida elegida. Una entrada de 2,3 s y una salida de 5 s se facturan como 8 s. Si no hay vídeo de entrada, solo se factura la salida. La solicitud no requiere cotización ni indicar la duración de entrada. Si falla la generación, se libera la reserva. El importe final aparece en el registro de uso.
Errores y correcciones
| Síntoma | Corrección |
|---|---|
| Duración/resolución/proporción no válidas | Use la enumeración y los rangos anteriores; la duración inteligente es exactamente -1 |
| Conflicto de fotograma/referencia, último fotograma sin el primero | Siga las reglas de combinación |
| Archivo/enlace junto con reescritura deshabilitada | Establezca prompt_extend:true |
| Fallo de obtención/formato/duración de medios | Use archivos públicos que cumplan con todas las restricciones de tamaño, formato y duración |
| Prompt ausente | Conserve un prompt de nivel superior no vacío para la API de APIMaster |
| Tarea fallida o moderada | Inspeccione error, luego corrija la solicitud; no cuente la aceptación como éxito |
