wan3.0-video API

Utilice el ID de modelo exacto wan3.0-video. El campo del modelo debe coincidir exactamente con esta página.

Salida de muestrawan3.0-videoPOST /v1/videos5.0s

Parámetros: duration=5resolution=1080Pratio=16:9

Prompt: Macro slow-motion shot of steamed milk poured into a ceramic cup of espresso, forming a rosetta latte art pattern. Warm morning light from a window, wooden counter, soft steam rising, shallow depth of field, commercial food photography, no text.

Solicitud que produjo esta muestra

{
  "model": "wan3.0-video",
  "prompt": "Macro slow-motion shot of steamed milk poured into a ceramic cup of espresso, forming a rosetta latte art pattern. Warm morning light from a window, wooden counter, soft steam rising, shallow depth of field, commercial food photography, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "1080P",
  "ratio": "16:9",
  "aspect_ratio": "16:9"
}

Autenticación y punto final

Utilice una clave API de Modelflare con https://modelflare.dev/v1. El punto de entrada de la puerta de enlace es POST /v1/videos.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Crear una tarea

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video",
    "input": {"prompt": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot"},
    "parameters": {"resolution": "1080P", "duration": 5, "audio": true}
  }'

Encuesta y descarga

Guardar el ID de la tarea. Sondear GET /v1/videos/{task_id} y descargar con GET /v1/videos/{task_id}/content. Las URL de resultados pueden caducar, así que transfiera el archivo lo antes posible.

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Solicitar notas

Wan comúnmente usa input y parameters; Los modos guiados por cuadros y los medios de referencia no deben mezclarse.

Solicitar parámetros

Wan3.0 usa input.prompt o input.media con controles de salida en parameters. Los medios pueden representar fotogramas, referencias, audio, archivos o páginas web.

Campo	Requerido	Notas
model	Sí	wan3.0-video
input.prompt	Condicional	Proporcionar esto o input.media
input.media[]	Condicional	first_frame, last_frame, reference_*, file o link
parameters.resolution	No	480P / 720P / 1080P (predeterminado 1080P)
parameters.ratio	No	16:9 / 9:16 / 1:1 / 4:3 / 3:4 / adaptive
parameters.duration	No	2–30 segundos, o -1 para duración automática
parameters.audio	No	Ya sea para generar audio sincronizado
parameters.prompt_extend	No	Establecer falso cuando este contrato modelo dedicado lo requiera
parameters.seed	No	Semilla aleatoria opcional
parameters.watermark	No	Si se debe agregar una marca de agua

Límites de entrada y salida

Wan3.0 admite texto, primeros/últimos cuadros, hasta 10 imágenes de referencia, 5 videos de referencia, 5 clips de audio de referencia y una entrada de archivo o página web. La salida es 480P, 720P o 1080P durante 2 a 30 segundos o sincronización automática -1. Los primeros/últimos fotogramas, medios de referencia, archivos y páginas web son flujos de trabajo mutuamente excluyentes seleccionados por input.media[].type.

Ejemplos de flujos de trabajo documentados

Wan3.0 utiliza un sobre input/parameters para texto, guía de cuadros, medios de referencia, archivos y páginas web; Estos flujos de trabajo son mutuamente excluyentes.

Primer y último fotograma

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video",
    "input": {"prompt": "镜头从第一帧平滑推进到最后一帧", "media": [
      {"type": "first_frame", "url": "https://example.com/first.png"},
      {"type": "last_frame", "url": "https://example.com/last.png"}
    ]},
    "parameters": {"resolution": "1080P", "duration": 8, "ratio": "adaptive", "audio": true}
  }'

Medios de referencia

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video",
    "input": {"prompt": "保持角色、动作和音色一致", "media": [
      {"type": "reference_image", "url": "https://example.com/character.png"},
      {"type": "reference_video", "url": "https://example.com/motion.mp4"},
      {"type": "reference_audio", "url": "https://example.com/voice.mp3"}
    ]},
    "parameters": {"resolution": "720P", "duration": -1, "ratio": "adaptive"}
  }'

Errores y tareas fallidas

Los parámetros del modelo no válidos devuelven un 4xx con un ID de solicitud. Una tarea asincrónica también puede fallar después de que la creación sea exitosa; utilice error_code y error_message de la respuesta de la encuesta como motivo final de la tarea. No vuelva a intentar la misma solicitud con una forma JSON diferente.

Alcance soportado

Esta página cubre las llamadas de generación y edición de modelos de Modelflare. El enriquecimiento de mapas o búsquedas, la administración de voz y la administración de bibliotecas de elementos son API de recursos fuera de esta superficie pública de llamada de modelo y no son campos de solicitud obligatorios.

Precios y facturación

Este modelo utiliza facturación de video por segundo. Consulte la página de precios de modelos para conocer el precio actual para el cliente, el precio de lista de referencia y las especificaciones completas.

Nota

Esta página documenta la interfaz pública de Modelflare; Los campos y límites que se muestran aquí son el contrato actual.

Variantes

ID del modelo	Diferencia
wan3.0-video	El modelo documentado en esta página.