Documentación de la API de Wan 3.0 Prime

Name: API de Wan 3.0 Prime
Brand: Alibaba
SKU: alibaba/wan-3.0-prime
Availability: InStock

Todo lo que necesitas para llamar a Wan 3.0 Prime desde tu código. URL base: https://cheapergen.com/api/v1. Pruébala primero en entorno de prueba.

¿Usas un agente de programación?

Pega esto en Claude Code, Cursor, Codex o cualquier agente de programación. Añade la API a tu proyecto, guarda la clave en CHEAPERGEN_API_KEY y prueba con una cotización gratuita antes de gastar nada.

Add Wan 3.0 Prime (CheaperGen endpoint alibaba/wan-3.0-prime/text-to-video) to this project by following https://cheapergen.com/agents/integrate.md

Qué lee tu agente

Autenticación

Crea una clave en Panel → Claves de API y envíala como token Bearer. Conserva las claves en el servidor.

export CHEAPERGEN_API_KEY="cg_live_…"

# every request
Authorization: Bearer $CHEAPERGEN_API_KEY

Wan 3.0 Prime Texto a video API

POST/api/v1/run/alibaba/wan-3.0-prime/text-to-video

Envía una tarea asíncrona y devuelve 202 con un ID de generación. Consulta GET /api/v1/generations/{id} o proporciona webhook_url. Consulta ciclo de vida del trabajo.

Parámetros de entrada

Nombre	Tipo	Descripción	Afecta al precio
`prompt`obligatorio	string	Describe la toma: sujeto, acción, movimiento de cámara, iluminación y estilo.	No
`aspect_ratio`	string (enum)	Formato del fotograma de salida. Valores: 16:9 · 9:16 · 1:1 · 4:3 · 3:4 Valor predeterminado: 16:9	Sí
`resolution`	string (enum)	Resolución de salida. Las resoluciones más altas cuestan más por segundo. Valores: 480p · 720p · 1080p Valor predeterminado: 720p	Sí
`duration`	integer	Duración del clip generado en segundos (2–30s). Se cobra por segundo. Intervalo: 2–30s Valor predeterminado: 5	Sí
`generate_audio`	boolean	Genera sonido, ambiente y diálogos sincronizados. Sin coste adicional. Valor predeterminado: true	No
`negative_prompt`	string	Elementos que quieres evitar en el resultado.	No
`seed`	integer	Usa la misma semilla y los mismos ajustes para reproducir un resultado. Déjalo vacío para usar una semilla aleatoria.	No
`webhook_url`	string (URL)	Opcional. Enviaremos aquí la generación terminada mediante una solicitud POST, firmada con el secreto de tu webhook. Webhooks	No

Solicitud

const API = "https://cheapergen.com/api/v1";
const headers = {
  Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
  "Content-Type": "application/json",
};

// 1. Submit the job
let job = await fetch(`${API}/run/alibaba/wan-3.0-prime/text-to-video`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": "Vendedor de comida callejera en Bangkok voltea fideos en un wok en llamas; bokeh de mercado nocturno y cámara en mano",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5
  }),
}).then((r) => r.json());

// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
  await new Promise((r) => setTimeout(r, 3000));
  job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}

console.log(job.status === "succeeded" ? job.output.video.url : job.error);

import os, time, requests

API = "https://cheapergen.com/api/v1"
headers = {"Authorization": f"Bearer {os.environ['CHEAPERGEN_API_KEY']}"}

# 1. Submit the job
job = requests.post(f"{API}/run/alibaba/wan-3.0-prime/text-to-video", headers=headers, json={
    "prompt": "Vendedor de comida callejera en Bangkok voltea fideos en un wok en llamas; bokeh de mercado nocturno y cámara en mano",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5
}).json()

# 2. Poll until it finishes (or pass "webhook_url" and skip polling)
while job["status"] in ("queued", "running"):
    time.sleep(3)
    job = requests.get(f"{API}/generations/{job['id']}", headers=headers).json()

print(job["status"], job["output"]["video"]["url"] if job["status"] == "succeeded" else job["error"])

curl -X POST https://cheapergen.com/api/v1/run/alibaba/wan-3.0-prime/text-to-video \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "Vendedor de comida callejera en Bangkok voltea fideos en un wok en llamas; bokeh de mercado nocturno y cámara en mano",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": 5
}'

Respuesta

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "alibaba/wan-3.0-prime",
  "endpoint": "alibaba/wan-3.0-prime/text-to-video",
  "mode": "text-to-video",
  "status": "queued",
  "input": {
    "prompt": "Vendedor de comida callejera en Bangkok voltea fideos en un wok en llamas; bokeh de mercado nocturno y cámara en mano",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5
  },
  "output": null,
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": true,
    "official_usd": null,
    "list_price_source": "official",
    "list_price_label": "Official",
    "saved_usd": null
  },
  "source": "api",
  "started_at": null,
  "completed_at": null,
  "urls": {
    "get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4",
    "cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4/cancel"
  },
  "created_at": "2026-10-15T09:21:04Z"
}

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "alibaba/wan-3.0-prime",
  "endpoint": "alibaba/wan-3.0-prime/text-to-video",
  "mode": "text-to-video",
  "status": "succeeded",
  "input": {
    "prompt": "Vendedor de comida callejera en Bangkok voltea fideos en un wok en llamas; bokeh de mercado nocturno y cámara en mano",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5
  },
  "output": {
    "video": {
      "url": "https://cdn.cheapergen.com/outputs/gen_8c2Q.mp4",
      "content_type": "video/mp4",
      "duration": 5,
      "width": 1280,
      "height": 720
    }
  },
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": false,
    "official_usd": 0.264,
    "list_price_source": "official",
    "list_price_label": "Official",
    "saved_usd": 0.0385
  },
  "source": "api",
  "created_at": "2026-10-15T09:21:04Z",
  "started_at": "2026-10-15T09:21:06Z",
  "completed_at": "2026-10-15T09:22:31Z"
}

Wan 3.0 Prime Imagen a video API

POST/api/v1/run/alibaba/wan-3.0-prime/image-to-video

Envía una tarea asíncrona y devuelve 202 con un ID de generación. Consulta GET /api/v1/generations/{id} o proporciona webhook_url. Consulta ciclo de vida del trabajo.

Parámetros de entrada

Nombre	Tipo	Descripción	Afecta al precio
`prompt`obligatorio	string	Describe la toma: sujeto, acción, movimiento de cámara, iluminación y estilo.	No
`image_url`obligatorio	string (URL)	Imagen que se usará como fotograma inicial. JPG/PNG/WebP, URL o carga de archivo.	No
`resolution`	string (enum)	Resolución de salida. Las resoluciones más altas cuestan más por segundo. Valores: 480p · 720p · 1080p Valor predeterminado: 720p	Sí
`duration`	integer	Duración del clip generado en segundos (2–30s). Se cobra por segundo. Intervalo: 2–30s Valor predeterminado: 5	Sí
`generate_audio`	boolean	Genera sonido, ambiente y diálogos sincronizados. Sin coste adicional. Valor predeterminado: true	No
`negative_prompt`	string	Elementos que quieres evitar en el resultado.	No
`seed`	integer	Usa la misma semilla y los mismos ajustes para reproducir un resultado. Déjalo vacío para usar una semilla aleatoria.	No
`webhook_url`	string (URL)	Opcional. Enviaremos aquí la generación terminada mediante una solicitud POST, firmada con el secreto de tu webhook. Webhooks	No

Solicitud

const API = "https://cheapergen.com/api/v1";
const headers = {
  Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
  "Content-Type": "application/json",
};

// 1. Submit the job
let job = await fetch(`${API}/run/alibaba/wan-3.0-prime/image-to-video`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": "El viento suave mueve las cortinas; la cámara retrocede lentamente para mostrar la habitación",
    "image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
    "resolution": "720p",
    "duration": 5
  }),
}).then((r) => r.json());

// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
  await new Promise((r) => setTimeout(r, 3000));
  job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}

console.log(job.status === "succeeded" ? job.output.video.url : job.error);

import os, time, requests

API = "https://cheapergen.com/api/v1"
headers = {"Authorization": f"Bearer {os.environ['CHEAPERGEN_API_KEY']}"}

# 1. Submit the job
job = requests.post(f"{API}/run/alibaba/wan-3.0-prime/image-to-video", headers=headers, json={
    "prompt": "El viento suave mueve las cortinas; la cámara retrocede lentamente para mostrar la habitación",
    "image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
    "resolution": "720p",
    "duration": 5
}).json()

# 2. Poll until it finishes (or pass "webhook_url" and skip polling)
while job["status"] in ("queued", "running"):
    time.sleep(3)
    job = requests.get(f"{API}/generations/{job['id']}", headers=headers).json()

print(job["status"], job["output"]["video"]["url"] if job["status"] == "succeeded" else job["error"])

curl -X POST https://cheapergen.com/api/v1/run/alibaba/wan-3.0-prime/image-to-video \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "El viento suave mueve las cortinas; la cámara retrocede lentamente para mostrar la habitación",
  "image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
  "resolution": "720p",
  "duration": 5
}'

Respuesta

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "alibaba/wan-3.0-prime",
  "endpoint": "alibaba/wan-3.0-prime/image-to-video",
  "mode": "image-to-video",
  "status": "queued",
  "input": {
    "prompt": "El viento suave mueve las cortinas; la cámara retrocede lentamente para mostrar la habitación",
    "image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
    "resolution": "720p",
    "duration": 5
  },
  "output": null,
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": true,
    "official_usd": null,
    "list_price_source": "official",
    "list_price_label": "Official",
    "saved_usd": null
  },
  "source": "api",
  "started_at": null,
  "completed_at": null,
  "urls": {
    "get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4",
    "cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4/cancel"
  },
  "created_at": "2026-10-15T09:21:04Z"
}

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "alibaba/wan-3.0-prime",
  "endpoint": "alibaba/wan-3.0-prime/image-to-video",
  "mode": "image-to-video",
  "status": "succeeded",
  "input": {
    "prompt": "El viento suave mueve las cortinas; la cámara retrocede lentamente para mostrar la habitación",
    "image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
    "resolution": "720p",
    "duration": 5
  },
  "output": {
    "video": {
      "url": "https://cdn.cheapergen.com/outputs/gen_8c2Q.mp4",
      "content_type": "video/mp4",
      "duration": 5,
      "width": 1280,
      "height": 720
    }
  },
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": false,
    "official_usd": 0.264,
    "list_price_source": "official",
    "list_price_label": "Official",
    "saved_usd": 0.0385
  },
  "source": "api",
  "created_at": "2026-10-15T09:21:04Z",
  "started_at": "2026-10-15T09:21:06Z",
  "completed_at": "2026-10-15T09:22:31Z"
}

Wan 3.0 Prime Video a partir de referencias API

POST/api/v1/run/alibaba/wan-3.0-prime/reference-to-video

Envía una tarea asíncrona y devuelve 202 con un ID de generación. Consulta GET /api/v1/generations/{id} o proporciona webhook_url. Consulta ciclo de vida del trabajo.

Parámetros de entrada

Nombre	Tipo	Descripción	Afecta al precio
`prompt`obligatorio	string	Describe la toma: sujeto, acción, movimiento de cámara, iluminación y estilo.	No
`reference_image_urls`	string[] (URLs)	Hasta 4 imágenes para definir personajes, productos, estilos o escenas. Menciónalas en el prompt como @Image1, @Image2… Máximo de elementos: 4	No
`reference_video_urls`	string[] (video URLs)	Hasta 5 clips de MP4/MOV para definir movimientos, movimientos de cámara o efectos (1–15 s cada uno, 15 s en total, ≤ 100 MB cada uno). Menciónalos como @Video1, @Video2… Los segundos de video de referencia se facturan como los de salida; el total de referencia y salida no puede superar los 30 s. Máximo de elementos: 5	Sí
`reference_audio_urls`	string[] (audio URLs)	Hasta 5 clips de MP3/WAV para definir voces, música o sonidos (1–15 s cada uno, 15 s en total, ≤ 15 MB cada uno). Menciónalos como @Audio1, @Audio2… Máximo de elementos: 5	No
`aspect_ratio`	string (enum)	Formato del fotograma de salida. Valores: 16:9 · 9:16 · 1:1 · 4:3 · 3:4 Valor predeterminado: 16:9	Sí
`resolution`	string (enum)	Resolución de salida. Las resoluciones más altas cuestan más por segundo. Valores: 480p · 720p · 1080p Valor predeterminado: 720p	Sí
`duration`	integer	Duración del clip generado en segundos (2–30s). Se cobra por segundo. Intervalo: 2–30s Valor predeterminado: 5	Sí
`generate_audio`	boolean	Genera sonido, ambiente y diálogos sincronizados. Sin coste adicional. Valor predeterminado: true	No
`negative_prompt`	string	Elementos que quieres evitar en el resultado.	No
`seed`	integer	Usa la misma semilla y los mismos ajustes para reproducir un resultado. Déjalo vacío para usar una semilla aleatoria.	No
`webhook_url`	string (URL)	Opcional. Enviaremos aquí la generación terminada mediante una solicitud POST, firmada con el secreto de tu webhook. Webhooks	No

Solicitud

const API = "https://cheapergen.com/api/v1";
const headers = {
  Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
  "Content-Type": "application/json",
};

// 1. Submit the job
let job = await fetch(`${API}/run/alibaba/wan-3.0-prime/reference-to-video`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": "La mujer de @Image1 recorre el café de @Image2 y pide un café, moviéndose como en @Video1",
    "reference_image_urls": [
      "https://cdn.cheapergen.com/samples/reference-1.jpg",
      "https://cdn.cheapergen.com/samples/reference-2.jpg"
    ],
    "reference_video_urls": [
      "https://cdn.cheapergen.com/samples/reference-1.mp4"
    ],
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5
  }),
}).then((r) => r.json());

// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
  await new Promise((r) => setTimeout(r, 3000));
  job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}

console.log(job.status === "succeeded" ? job.output.video.url : job.error);

import os, time, requests

API = "https://cheapergen.com/api/v1"
headers = {"Authorization": f"Bearer {os.environ['CHEAPERGEN_API_KEY']}"}

# 1. Submit the job
job = requests.post(f"{API}/run/alibaba/wan-3.0-prime/reference-to-video", headers=headers, json={
    "prompt": "La mujer de @Image1 recorre el café de @Image2 y pide un café, moviéndose como en @Video1",
    "reference_image_urls": [
        "https://cdn.cheapergen.com/samples/reference-1.jpg",
        "https://cdn.cheapergen.com/samples/reference-2.jpg"
    ],
    "reference_video_urls": [
        "https://cdn.cheapergen.com/samples/reference-1.mp4"
    ],
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5
}).json()

# 2. Poll until it finishes (or pass "webhook_url" and skip polling)
while job["status"] in ("queued", "running"):
    time.sleep(3)
    job = requests.get(f"{API}/generations/{job['id']}", headers=headers).json()

print(job["status"], job["output"]["video"]["url"] if job["status"] == "succeeded" else job["error"])

curl -X POST https://cheapergen.com/api/v1/run/alibaba/wan-3.0-prime/reference-to-video \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "La mujer de @Image1 recorre el café de @Image2 y pide un café, moviéndose como en @Video1",
  "reference_image_urls": [
    "https://cdn.cheapergen.com/samples/reference-1.jpg",
    "https://cdn.cheapergen.com/samples/reference-2.jpg"
  ],
  "reference_video_urls": [
    "https://cdn.cheapergen.com/samples/reference-1.mp4"
  ],
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": 5
}'

Respuesta

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "alibaba/wan-3.0-prime",
  "endpoint": "alibaba/wan-3.0-prime/reference-to-video",
  "mode": "reference-to-video",
  "status": "queued",
  "input": {
    "prompt": "La mujer de @Image1 recorre el café de @Image2 y pide un café, moviéndose como en @Video1",
    "reference_image_urls": [
      "https://cdn.cheapergen.com/samples/reference-1.jpg",
      "https://cdn.cheapergen.com/samples/reference-2.jpg"
    ],
    "reference_video_urls": [
      "https://cdn.cheapergen.com/samples/reference-1.mp4"
    ],
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5
  },
  "output": null,
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": true,
    "official_usd": null,
    "list_price_source": "official",
    "list_price_label": "Official",
    "saved_usd": null
  },
  "source": "api",
  "started_at": null,
  "completed_at": null,
  "urls": {
    "get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4",
    "cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4/cancel"
  },
  "created_at": "2026-10-15T09:21:04Z"
}

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "alibaba/wan-3.0-prime",
  "endpoint": "alibaba/wan-3.0-prime/reference-to-video",
  "mode": "reference-to-video",
  "status": "succeeded",
  "input": {
    "prompt": "La mujer de @Image1 recorre el café de @Image2 y pide un café, moviéndose como en @Video1",
    "reference_image_urls": [
      "https://cdn.cheapergen.com/samples/reference-1.jpg",
      "https://cdn.cheapergen.com/samples/reference-2.jpg"
    ],
    "reference_video_urls": [
      "https://cdn.cheapergen.com/samples/reference-1.mp4"
    ],
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5
  },
  "output": {
    "video": {
      "url": "https://cdn.cheapergen.com/outputs/gen_8c2Q.mp4",
      "content_type": "video/mp4",
      "duration": 5,
      "width": 1280,
      "height": 720
    }
  },
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": false,
    "official_usd": 0.264,
    "list_price_source": "official",
    "list_price_label": "Official",
    "saved_usd": 0.0385
  },
  "source": "api",
  "created_at": "2026-10-15T09:21:04Z",
  "started_at": "2026-10-15T09:21:06Z",
  "completed_at": "2026-10-15T09:22:31Z"
}

Obtén el resultado

Las generaciones son asíncronas. Consulta el estado hasta que status esté succeeded, failed o canceled, o proporciona webhook_url al enviar la solicitud. Las generaciones fallidas se reembolsan automáticamente.

curl https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4 \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY"

Más información: ciclo de vida del trabajo · webhooks · errores

precios de Wan 3.0 Prime

Paga por segundo de video a medida que lo usas, sin necesidad de suscripción. Las generaciones fallidas se reembolsan automáticamente.

Nivel	Precio oficial	CheaperGen	Ahorras
480p por segundo	~~$0,068~~/s	$0,0582/s	−15%
720p por segundo	~~$0,14~~/s	$0,1198/s Con un plan mensual: Pro $0,1191Max $0,1184	−14%
1080p por segundo	~~$0,28~~/s	$0,2394/s Con un plan mensual: Pro $0,2381Max $0,2368	−15%

Planes mensuales: precios más bajos en la mayoría de los modelos (indicados debajo de cada precio); puedes seguir pagando por uso. Pro $499/mes · Max $4999/mes.

Precio oficial: Precio de lista internacional de Alibaba Cloud Model Studio (Singapur) para wan3.0-video-prime ($0.068 / $0.14 / $0.28 por segundo; los segundos de video de referencia se facturan con la misma tarifa). Precios verificados el 18 de octubre de 2026.
Los segundos de video de referencia se facturan con la misma tarifa por segundo que el resultado.