Documentation de l’API Wan 3.0 Prime

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

Tout ce dont vous avez besoin pour appeler Wan 3.0 Prime depuis votre code. URL de base : https://cheapergen.com/api/v1. Essayez d’abord dans l’interface playground.

Vous utilisez un agent de programmation ?

Collez ceci dans Claude Code, Cursor, Codex ou tout autre agent de programmation. Il ajoute l’API à votre projet, conserve la clé dans CHEAPERGEN_API_KEY et teste le devis gratuit avant toute dépense.

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

Ce que votre agent lit

Authentification

Créez une clé dans Tableau de bord → Clés API et envoyez-la comme jeton Bearer. Conservez les clés côté serveur.

export CHEAPERGEN_API_KEY="cg_live_…"

# every request
Authorization: Bearer $CHEAPERGEN_API_KEY

API Wan 3.0 Prime Texte en vidéo

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

Envoie une tâche asynchrone et renvoie 202 avec un ID de génération. Interrogez GET /api/v1/generations/{id} ou indiquez webhook_url. Voir cycle de vie des tâches.

Paramètres d’entrée

Nom	Type	Description	Influe sur le prix
`prompt`requis	string	Décrivez le plan : sujet, action, mouvement de caméra, éclairage et style.	Non
`aspect_ratio`	string (enum)	Format de l’image de sortie. Valeurs : 16:9 · 9:16 · 1:1 · 4:3 · 3:4 Par défaut : 16:9	Oui
`resolution`	string (enum)	Résolution de sortie. Les résolutions supérieures coûtent plus cher par seconde. Valeurs : 480p · 720p · 1080p Par défaut : 720p	Oui
`duration`	integer	Durée du clip généré en secondes (2–30 s). La facturation se fait à la seconde. Plage : 2–30s Par défaut : 5	Oui
`generate_audio`	boolean	Générez un son synchronisé, une ambiance et des dialogues, sans frais supplémentaires. Par défaut : true	Non
`negative_prompt`	string	Éléments à éviter dans le résultat.	Non
`seed`	integer	Réutilisez le même seed et les mêmes paramètres pour reproduire un résultat. Laissez ce champ vide pour une valeur aléatoire.	Non
`webhook_url`	chaîne (URL)	Facultatif. Nous envoyons la génération terminée par POST à cette adresse, avec une signature calculée à l’aide de votre secret de webhook. Webhooks	Non

Requête

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": "Un vendeur de cuisine de rue à Bangkok fait sauter des nouilles dans un wok en flammes, flou bokeh du marché nocturne, caméra à l’épaule",
    "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": "Un vendeur de cuisine de rue à Bangkok fait sauter des nouilles dans un wok en flammes, flou bokeh du marché nocturne, caméra à l’épaule",
    "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": "Un vendeur de cuisine de rue à Bangkok fait sauter des nouilles dans un wok en flammes, flou bokeh du marché nocturne, caméra à l’épaule",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": 5
}'

Réponse

{
  "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": "Un vendeur de cuisine de rue à Bangkok fait sauter des nouilles dans un wok en flammes, flou bokeh du marché nocturne, caméra à l’épaule",
    "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": "Un vendeur de cuisine de rue à Bangkok fait sauter des nouilles dans un wok en flammes, flou bokeh du marché nocturne, caméra à l’épaule",
    "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"
}

API Wan 3.0 Prime Image en vidéo

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

Envoie une tâche asynchrone et renvoie 202 avec un ID de génération. Interrogez GET /api/v1/generations/{id} ou indiquez webhook_url. Voir cycle de vie des tâches.

Paramètres d’entrée

Nom	Type	Description	Influe sur le prix
`prompt`requis	string	Décrivez le plan : sujet, action, mouvement de caméra, éclairage et style.	Non
`image_url`requis	string (URL)	Image utilisée comme première image. JPG/PNG/WebP, URL ou téléversement.	Non
`resolution`	string (enum)	Résolution de sortie. Les résolutions supérieures coûtent plus cher par seconde. Valeurs : 480p · 720p · 1080p Par défaut : 720p	Oui
`duration`	integer	Durée du clip généré en secondes (2–30 s). La facturation se fait à la seconde. Plage : 2–30s Par défaut : 5	Oui
`generate_audio`	boolean	Générez un son synchronisé, une ambiance et des dialogues, sans frais supplémentaires. Par défaut : true	Non
`negative_prompt`	string	Éléments à éviter dans le résultat.	Non
`seed`	integer	Réutilisez le même seed et les mêmes paramètres pour reproduire un résultat. Laissez ce champ vide pour une valeur aléatoire.	Non
`webhook_url`	chaîne (URL)	Facultatif. Nous envoyons la génération terminée par POST à cette adresse, avec une signature calculée à l’aide de votre secret de webhook. Webhooks	Non

Requête

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": "Le vent fait doucement bouger les rideaux ; la caméra recule lentement pour dévoiler la pièce",
    "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": "Le vent fait doucement bouger les rideaux ; la caméra recule lentement pour dévoiler la pièce",
    "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": "Le vent fait doucement bouger les rideaux ; la caméra recule lentement pour dévoiler la pièce",
  "image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
  "resolution": "720p",
  "duration": 5
}'

Réponse

{
  "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": "Le vent fait doucement bouger les rideaux ; la caméra recule lentement pour dévoiler la pièce",
    "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": "Le vent fait doucement bouger les rideaux ; la caméra recule lentement pour dévoiler la pièce",
    "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"
}

API Wan 3.0 Prime Référence → vidéo

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

Envoie une tâche asynchrone et renvoie 202 avec un ID de génération. Interrogez GET /api/v1/generations/{id} ou indiquez webhook_url. Voir cycle de vie des tâches.

Paramètres d’entrée

Nom	Type	Description	Influe sur le prix
`prompt`requis	string	Décrivez le plan : sujet, action, mouvement de caméra, éclairage et style.	Non
`reference_image_urls`	string[] (URLs)	Jusqu’à 4 images pour les personnages, les produits, le style ou la scène. Mentionnez-les dans le prompt avec @Image1, @Image2… Nombre maximal d’éléments : 4	Non
`reference_video_urls`	string[] (video URLs)	Jusqu’à 5 clips MP4/MOV pour les mouvements, déplacements de caméra ou effets (1–15 s chacune, 15 s au total, ≤ 100 MB chacune). Mentionnez-les avec @Video1, @Video2… Les secondes des vidéos de référence sont facturées comme celles du résultat ; référence + résultat ne doivent pas dépasser 30 s. Nombre maximal d’éléments : 5	Oui
`reference_audio_urls`	string[] (audio URLs)	Jusqu’à 5 clips MP3/WAV pour la voix, la musique ou le son (1–15 s chacune, 15 s au total, ≤ 15 MB chacune). Mentionnez-les avec @Audio1, @Audio2… Nombre maximal d’éléments : 5	Non
`aspect_ratio`	string (enum)	Format de l’image de sortie. Valeurs : 16:9 · 9:16 · 1:1 · 4:3 · 3:4 Par défaut : 16:9	Oui
`resolution`	string (enum)	Résolution de sortie. Les résolutions supérieures coûtent plus cher par seconde. Valeurs : 480p · 720p · 1080p Par défaut : 720p	Oui
`duration`	integer	Durée du clip généré en secondes (2–30 s). La facturation se fait à la seconde. Plage : 2–30s Par défaut : 5	Oui
`generate_audio`	boolean	Générez un son synchronisé, une ambiance et des dialogues, sans frais supplémentaires. Par défaut : true	Non
`negative_prompt`	string	Éléments à éviter dans le résultat.	Non
`seed`	integer	Réutilisez le même seed et les mêmes paramètres pour reproduire un résultat. Laissez ce champ vide pour une valeur aléatoire.	Non
`webhook_url`	chaîne (URL)	Facultatif. Nous envoyons la génération terminée par POST à cette adresse, avec une signature calculée à l’aide de votre secret de webhook. Webhooks	Non

Requête

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 femme de @Image1 traverse le café de @Image2 et commande un café, en bougeant comme dans @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 femme de @Image1 traverse le café de @Image2 et commande un café, en bougeant comme dans @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 femme de @Image1 traverse le café de @Image2 et commande un café, en bougeant comme dans @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
}'

Réponse

{
  "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 femme de @Image1 traverse le café de @Image2 et commande un café, en bougeant comme dans @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 femme de @Image1 traverse le café de @Image2 et commande un café, en bougeant comme dans @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"
}

Récupérer le résultat

Les générations sont asynchrones. Interrogez leur état jusqu’à ce que status soit succeeded, failed ou canceled, ou indiquez webhook_url lors de l’envoi. Les générations échouées sont automatiquement remboursées.

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

Pour en savoir plus : cycle de vie des tâches · webhooks · erreurs

Tarifs de Wan 3.0 Prime

Payez par seconde de vidéo à l’usage, sans abonnement requis. Les générations échouées sont remboursées automatiquement.

Offre	Prix officiel	CheaperGen	Vous économisez
480p par seconde	~~$0,068~~/s	$0,0582/s	−15%
720p par seconde	~~$0,14~~/s	$0,1198/s Avec un forfait mensuel : Pro $0,1191Max $0,1184	−14%
1080p par seconde	~~$0,28~~/s	$0,2394/s Avec un forfait mensuel : Pro $0,2381Max $0,2368	−15%

Forfaits mensuels vous fait bénéficier de tarifs réduits sur la plupart des modèles (indiqués sous chaque prix), tout en gardant le paiement à l’usage. Pro $499/mois · Max $4 999/mois.

Prix officiel : Prix catalogue international d’Alibaba Cloud Model Studio (Singapour) pour wan3.0-video-prime ($0.068 / $0.14 / $0.28 par seconde ; les secondes des vidéos de référence sont facturées au même tarif). Tarifs vérifiés le 18 octobre 2026.
Les secondes des vidéos de référence sont facturées au même tarif par seconde que le résultat.