Tutorial de la API de Wan 3.0 Prime：texto a video, primer y último fotograma, y video de referencia

TL;DR

• Wan 3.0 Prime (万相 3.0 versión acelerada) es la vía rápida de Wan 3.0 de Alibaba, con el nombre de modelo wan3.0-video-prime. Un solo modelo puede hacer texto a video, video con primer y último fotograma y video con referencia; el material de referencia puede ser una imagen, un audio, o incluso un documento o una página web. Cada video dura de 2 a 30 segundos y por defecto incluye sonido. Abre la página del modelo para generar en línea.
• Cobro por segundo: 480P $0.0875 por segundo, 720P $0.18, 1080P $0.36. 5 segundos en 480P solo cuestan $0.4375.
• Dos errores comunes: la resolución debe escribirse en MAYÚSCULAS 480P / 720P / 1080P, y el valor por defecto es 1080P; además, Prime no acepta videos de referencia.

Primero, el resultado

Texto a video, 480P, 5 segundos, con sonido (si activas el sonido podrás oír la lluvia, el tráfico y el chisporroteo de la parrilla):

Rain streaking down a narrow neon-lit alley at night; a slow dolly-forward past
steaming street-food stalls, magenta and cyan reflections rippling in the wet
pavement, a tabby cat darting between crates mid-shot. Ambient sound: steady
rain, distant traffic hiss, the sizzle of a grill and a low synth drone.

Genera con este prompt → (5 segundos, 480P, 16:9, con sonido)

wan3.0-video-prime, 480P, 5 segundos, con sonido, $0.4375.

Video con referencia: sube una imagen de una figurita de zorro de cerámica y haz que se mueva manteniendo su apariencia.

Bring the referenced ceramic fox figurine to life: it slowly turns its head
toward camera, blinks, and tilts with a curious expression; subtle idle
breathing, a light breeze stirring the tiny scarf, soft studio key light on a
clean seamless backdrop, smooth loopable motion.

Genera con este prompt → (sube tu imagen de referencia, 5 segundos, 480P, 9:16)

wan3.0-video-prime, imagen de referencia, 480P, 5 segundos, 9:16, $0.4375.

curl: el primer video

5 segundos en 480P, $0.4375:

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video-prime",
    "input": {
      "prompt": "一只橘猫趴在洒满阳光的窗台上打哈欠，尾巴轻轻摆动，镜头缓慢推近，暖色调",
      "resolution": "480P",
      "duration": 5,
      "aspect_ratio": "16:9",
      "audio": false
    }
  }'

Cuando devuelva data.taskId, consulta con GET /v1/tasks/{taskId} hasta que status sea success y luego descarga output[0].url.

Python: enviar, consultar y descargar

# pip install requests; primero export HIAPI_KEY=tu Key
import os, time, uuid, requests

API = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}

def generate(timeout_s=900, **inp):
    # 重试提交同一个任务时带同一个 Idempotency-Key，避免重复扣费
    r = requests.post(API, json={"model": "wan3.0-video-prime", "input": inp},
                      headers={**H, "Idempotency-Key": str(uuid.uuid4())}, timeout=30)
    r.raise_for_status()
    task_id = r.json()["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"{API}/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(10)
    raise TimeoutError(task_id)

# 参考生视频：让参考图里的产品动起来，480P 5 秒（$0.4375）
url = generate(
    prompt="让参考图里的香水瓶在黑色大理石上缓慢旋转，侧逆光扫过瓶身，镜头缓慢推近",
    reference_image_urls=["https://your-cdn.example.com/perfume.jpg"],
    resolution="480P", duration=5, aspect_ratio="9:16", audio=False,
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

Tres formas de uso

Uso	Qué enviar	Descripción
Texto a video	Solo prompt
Primer y último fotograma	first_frame_url, opcionalmente last_frame_url	No se puede usar junto con material de referencia
Video con referencia	reference_image_urls (máx. 10), reference_audio_urls (máx. 5, deben usarse junto con imágenes), reference_file_urls o reference_link_urls (máx. 1 de cada, elige uno)	En el prompt, haz referencia al material en orden con Image1, Audio1

Los documentos y páginas web de referencia son una característica de Wan 3.0: puedes entregar al modelo un PDF de normas de marca o el enlace de una página de producto y pedirle que genere el video según esa información. La página web debe poder abrirse sin iniciar sesión.

Tabla de parámetros

Parámetro	Valores	Descripción
prompt	Cadena, obligatorio	Describe la escena, la acción, la cámara, la iluminación y el sonido
resolution	480P / 720P / 1080P, por defecto 1080P	MAYÚSCULAS, determina directamente el precio
duration	Entero de 2 a 30, por defecto 5	Unidad en segundos
aspect_ratio	adaptive 16:9 4:3 1:1 3:4 9:16, por defecto adaptive	adaptive elige automáticamente según el material y el prompt
audio	Por defecto true	Pista de audio sincronizada, sin coste adicional
seed	0–2147483647	Semilla fija para facilitar la reproducibilidad
first_frame_url / last_frame_url	URL de imagen	Primer y último fotograma
reference_image_urls, etc.	Ver tabla anterior	Video con referencia

Calculemos el coste

Duración	480P ($0.0875/s)	720P ($0.18/s)	1080P ($0.36/s)
5 segundos	$0.4375	$0.90	$1.80
10 segundos	$0.875	$1.80	$3.60
30 segundos	$2.625	$5.40	$10.80

Primero ajusta el prompt en 480P y, cuando esté listo, pasa a 720P o 1080P. Si no tienes prisa, la versión estándar de Wan 3.0 (wan3.0-video) en 720P cuesta solo $0.08 por segundo y además acepta videos de referencia. Consulta todos los precios en Precios de la API de Wan 3.0 Prime.

Antes de lanzar

• Usa callbacks en lugar de polling: en el nivel superior de la solicitud (al mismo nivel que input) añade "callback": {"url": "https://tu-dominio/hiapi/callback"} y deduplica por taskId.
• Guarda los archivos a tiempo: output[0].url es un enlace temporal.
• Reintenta con clave de idempotencia: añade Idempotency-Key en la cabecera; reintentar con la misma clave solo crea una tarea.
• Reembolso automático por fallo: solo se cobra por los videos generados con éxito.

Preguntas frecuentes

¿Por qué da error al enviar 720p?

La resolución debe escribirse en mayúsculas. Si envías minúsculas, devuelve 400: resolution: value must be one of '480P', '720P', '1080P'.

¿Se puede enviar un video de referencia?

Prime no puede; no acepta el parámetro reference_video_urls. Si necesitas video de referencia, usa la versión estándar de Wan 3.0 wan3.0-video.

¿Se puede desactivar el sonido?

Sí, audio: false. Por defecto está activado y el precio no cambia.

¿Cuál es la diferencia entre Prime y la versión estándar de Wan 3.0?

Los parámetros y las especificaciones de salida son iguales; Prime es la vía acelerada. La versión estándar también tiene nivel 480P ($0.04/s), pero 720P y 1080P cuestan más del doble por segundo y no acepta videos de referencia.

Para más formas de escribir prompts, consulta Casos de prompts de Wan 3.0 Prime, y para comparar con la generación anterior, Cómo elegir entre Wan 3.0 y Wan 2.7. También puedes ir a la página del modelo para generar el del callejón lluvioso.