APIMaster.ai

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