CheaperGen
AlibabaTutorial

So verwenden Sie die Wan 3.0 Prime-API

Eine Schritt-für-Schritt-Anleitung zur Wan 3.0 Prime-API mit Node.js, Python und cURL: einen text zu video-Auftrag absenden, den Status abfragen oder einen Webhook empfangen und anschließend die video herunterladen. Das folgende Beispiel kostet $0,60.

Endpunkte
3
Text zu Video · Bild zu Video · Referenz zu Video
Beispielanfrage
$0,60
Text zu Video
Sprachen
3
Node.js · Python · cURL
Fehlgeschlagene Aufträge
$0
automatisch erstattet
1

API-Schlüssel abrufen

Erstellen Sie ein Konto, laden Sie Guthaben auf und erstellen Sie im Dashboard unter „API-Schlüssel“ einen Schlüssel. Speichern Sie ihn als CHEAPERGEN_API_KEY auf Ihrem Server. Jede Anfrage sendet ihn als Bearer-Token.

So erhalten Sie einen Wan 3.0 Prime-API-Schlüssel
2

Wählen Sie einen Wan 3.0 Prime-Endpunkt

Jede Aufgabe hat einen eigenen Endpunkt. Alle erwarten einen JSON-Body und geben eine Generierung zurück, deren Status Sie abfragen können.

Wan 3.0 Prime API-Endpunkte, erforderliche Eingaben und Preise
AufgabeEndpunktErforderlichAb
Text zu Videoalibaba/wan-3.0-prime/text-to-videoprompt$0,0582 pro Sekunde
Bild zu Videoalibaba/wan-3.0-prime/image-to-videoprompt, image_url$0,0582 pro Sekunde
Referenz zu Videoalibaba/wan-3.0-prime/reference-to-videoprompt$0,0582 pro Sekunde
3

Einen text zu video-Auftrag absenden

Dieses Programm übermittelt den Auftrag, fragt alle 3 Sekunden bis zum Abschluss den Status ab und gibt die video-URL aus. Ersetzen Sie Prompt und Einstellungen durch Ihre eigenen.

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": "Straßenimbiss-Verkäufer in Bangkok wendet Nudeln im lodernden Wok, Bokeh des Nachtmarkts, Handkamera",
    "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);
4

Wichtige Parameter festlegen

Die Einstellungen für alibaba/wan-3.0-prime/text-to-video und ihre Auswirkungen auf den Preis.

Wan 3.0 Prime Text zu Video Parameter und ihre Auswirkungen auf den Preis
ParameterTyp · StandardwertBeschreibungPreisauswirkung
aspect_ratiostring (enum) · 16:9Format des Ausgabebilds.
16:9 · 9:16 · 1:1 · 4:3 · 3:4
Ja
resolutionstring (enum) · 720pAusgabeauflösung. Höhere Auflösungen kosten pro Sekunde mehr.
480p · 720p · 1080p
480p: $0,0582 pro Sekunde
720p: $0,1198 pro Sekunde
1080p: $0,2394 pro Sekunde
durationinteger · 5Länge des generierten Clips in Sekunden (2–30 s). Abrechnung pro Sekunde.Abrechnung pro Sekunde
generate_audioboolean · trueGenerieren Sie synchronisierten Ton, Atmosphäre und Dialog. Ohne Aufpreis.Keine
negative_promptstringDinge, die in der Ausgabe vermieden werden sollen.Keine
seedintegerVerwenden Sie denselben Seed und dieselben Einstellungen, um ein Ergebnis zu reproduzieren. Leer lassen für Zufallswerte.Keine

Weitere Wan 3.0 Prime-Endpunkte verwenden dieselbe Struktur, aber jeweils eigene Eingabefelder:

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

{
  "prompt": "Sanfter Wind bewegt die Vorhänge. Die Kamera fährt langsam zurück und gibt den Raum frei.",
  "image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
  "resolution": "720p",
  "duration": 5
}

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

{
  "prompt": "Die Frau in @Image1 geht durch das Café aus @Image2 und bestellt Kaffee. Ihre Bewegung orientiert sich an @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
}
5

Ergebnis abrufen

Ein Auftrag wechselt von queued zu running und anschließend zu succeeded, failed oder canceled. Fragen Sie GET /api/v1/generations/{id} ab oder übergeben Sie webhook_url; dann senden wir Ihnen das Ergebnis per POST. Laden Sie die Ausgabe herunter und speichern Sie sie selbst.

200 — succeeded
{
  "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": "Straßenimbiss-Verkäufer in Bangkok wendet Nudeln im lodernden Wok, Bokeh des Nachtmarkts, Handkamera",
    "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"
}
Webhook-Signaturen prüfen
6

Preis vor der Ausführung abfragen

Der Angebotsendpunkt ist kostenlos und erfordert keinen Schlüssel. Er gibt den Preis, der offizielle Preis und Ihren Rabatt genau für die übermittelten Eingaben zurück.

curl -X POST https://cheapergen.com/api/v1/quote/alibaba/wan-3.0-prime/text-to-video \
  -H "Content-Type: application/json" \
  -d '{"prompt":"Straßenimbiss-Verkäufer in Bangkok wendet Nudeln im lodernden Wok, Bokeh des Nachtmarkts, Handkamera","aspect_ratio":"16:9","resolution":"720p","duration":5}'
API-Fehler und was Sie tun können
StatusCodeBedeutung
400invalid_requestEin Parameter fehlt oder liegt außerhalb des zulässigen Bereichs – die Meldung nennt ihn.
401unauthorizedAPI-Schlüssel fehlt, ist fehlerhaft formatiert oder wurde widerrufen.
402insufficient_balanceIhr Guthaben reicht nicht für den angebotenen Preis. Laden Sie es auf oder aktivieren Sie die automatische Aufladung.
429rate_limitedZu viele Anfragen oder gleichzeitig laufende Generierungen. Warten Sie kurz und versuchen Sie es erneut.
502upstream_errorDie Verarbeitung durch das Modell ist fehlgeschlagen. Der reservierte Betrag wird erstattet; Sie können es erneut versuchen.
503model_unavailableDerzeit ist kein geeigneter Verarbeitungsweg verfügbar. Versuchen Sie es später erneut oder wählen Sie ein anderes Modell.
Vollständige Wan 3.0 Prime-API-Dokumentation

FAQ

Wan 3.0 Prime-API: häufige Fragen

Nein. Die API verwendet einfaches HTTPS mit JSON. Die Beispiele für Node.js (fetch) und Python (requests) auf dieser Seite sind vollständige Programme. Jede Sprache, die HTTP-Anfragen senden kann, funktioniert.

Ja. Fügen Sie „webhook_url“ in den Anfrage-Body ein. Wir senden die abgeschlossene Generierung dann signiert an diese Adresse, mit dem Header CheaperGen-Signature (HMAC-SHA256 aus Zeitstempel und rohem Body). GET /api/v1/generations/{id} zum Abfragen des Status funktioniert ebenfalls.

Übergeben Sie öffentliche URLs in "image_url", "reference_image_urls", "reference_video_urls", "reference_audio_urls". Dateien ohne öffentliche URL können Sie zuerst mit POST /api/v1/uploads hochladen. Der Aufruf gibt eine URL zurück, die Sie in der Anfrage verwenden.

Text zu Video kostet ab $0,0582 pro Sekunde; die Beispielanfrage auf dieser Seite kostet $0,60, 14% unter der offizielle Preis. Fehlgeschlagene Generierungen werden automatisch erstattet.