Zwei Entwickler haben heute Morgen die PixVerse-Dokumentation gelesen. Einer hat eine Negative-Prompt-Funktion ausgeliefert. Der andere hat erfahren, dass dieser Parameter nicht mehr existiert.
Beide haben offizielle Seiten gelesen. Das ist der wahre Zustand der PixVerse-API im Jahr 2026: ein leistungsfähiger, schnelllebiger Videogenerierungsdienst, der in eine Dokumentation gehüllt ist, in der alte und neue Seiten leise widersprechen. Die meisten PixVerse AI API-Entwicklerfragen laufen auf zwei Dinge hinaus. Wo sind die Dokumente, die tatsächlich aktuell sind? Und was wird ein Clip kosten, sobald der Code funktioniert?
Dieser Leitfaden beantwortet beide Fragen. Jeder Endpunkt, jeder Parameter und jeder Preis unten wurde diese Woche am 23. Juli 2026 gegen Erstanbieter-Seiten geprüft.
Wichtige Erkenntnisse
- Die offizielle PixVerse-API-Dokumentation befindet sich unter docs.platform.pixverse.ai. Schlüssel und Guthaben befinden sich unter platform.pixverse.ai. Die Consumer-App unter app.pixverse.ai ist ein separates Produkt mit separater Abrechnung.
- Jeder Aufruf benötigt zwei Header: API-KEY plus eine frische Ai-trace-id UUID pro Anfrage. Die Generierung ist asynchron: einreichen, eine video_id erhalten, auf das Ergebnis warten.
- Die Dokumentation widerspricht sich an einigen Stellen. Ältere How-to-Seiten zeigen immer noch negative_prompt und water_mark; die aktuelle Generierungsreferenz hat keines von beiden. Wenn Seiten sich widersprechen, vertrauen Sie der Endpunkt-Referenz.
- Die offizielle Abrechnung erfolgt in Credits (10 $ kaufen 1.000). Das gleiche V6-Modell läuft gemessen auf Atlas Cloud ab 0,025 $ pro Sekunde, wo der standardmäßige 5-Sekunden-720p-Clip mit Audio 0,30 $ kostet gegenüber 0,60 $ in Paketpreis-Credits.
Die PixVerse-API-Dokumentationskarte: Wo die echten Dokumente leben
Die Suche nach PixVerse-API-Dokumentation liefert vier Erstanbieter-Oberflächen und eine Menge Wiederverkäufer. Die vier, die wichtig sind:
| Oberfläche | URL | Abdeckung |
|---|---|---|
| Plattform-Dokumentation | docs.platform.pixverse.ai | Schnellstart, vollständige API-Referenz, Credit-Preise, Fehlerreferenz, FAQ |
| Entwickler-Konsole | platform.pixverse.ai | API-Schlüssel erstellen, Credit-Pakete kaufen, Nutzung verfolgen |
| Consumer-App | app.pixverse.ai | Die Web-App. Ihre Pläne, kostenlosen Credits und Wasserzeichenregeln gelten nicht für die API |
| Offizieller MCP-Server | github.com/PixVerseAI/PixVerse-MCP | Offizieller Wrapper, der es KI-Assistenten erlaubt, PixVerse direkt aufzurufen |
Die Trennung, die Leute stolpern lässt, ist App vs. Plattform. Die App verkauft monatliche Pläne ab 10 $ und verteilt variable tägliche kostenlose Credits. Die Plattform verkauft API-Credits und Mitgliedschaften auf einem separaten Konto. Ein bezahltes App-Abonnement gibt Ihnen nichts auf der API-Seite und umgekehrt.
Ein wirklich nützliches Detail versteckt sich in der Plattform-Dokumentation: eine konsolidierte Klartext-Seite namens PixVerse-api-llm.txt, die die gesamte API-Referenz in ein Dokument packt. Fügen Sie sie in Ihren Coding-Assistenten ein, und er kann PixVerse-Aufrufe gegen aktuelle Spezifikationen schreiben, anstatt was auch immer seine Trainingsdaten gespeichert haben.
Die Dokumentation beschreibt einen Dienst hinter „über 100 Millionen Kreativen und Unternehmen in 175 Ländern.“ Der Maßstab ist real. Die damit einhergehende Versionsfluktuation ist der Grund, warum dieser Artikel einen Abschnitt über Widersprüche hat.
Zwei Möglichkeiten, die PixVerse AI API heute zu nutzen
Die Integration gegen PixVerses eigene Plattform wird im nächsten Abschnitt ausführlich erläutert. Der schnellste Weg, die Modelle zuerst zu berühren, ist über einen Host: Atlas Cloud betreibt PixVerse V6 und C1 unter seinen über 400 Modellen, abgerechnet pro Sekunde in Dollar, ohne Credit-Pakete und ohne Wasserzeichen. Die PixVerse-Familiy-Seite listet alle neun gehosteten Endpunkte, von Text-zu-Video über Referenz-zu-Video bis hin zu Erweitern. Zwei Wege: Testen Sie im Playground, dann rufen Sie denselben Endpunkt aus Code auf. Der natürliche Ausgangspunkt ist der V6 Text-zu-Video-Playground.
Methode 1: Testen Sie die PixVerse V6 API im Playground
Bevor Sie Code schreiben, verbringen Sie zehn Minuten hier. Der Playground ist derselbe Endpunkt, den Ihr Code aufrufen wird, mit einem beigefügten Preisangebot.
- Melden Sie sich an und öffnen Sie den Playground. Das Prompt-Feld ist die einzige erforderliche Eingabe.
- Stellen Sie Dauer, Qualität und Seitenverhältnis ein. Standardwerte sind 5 Sekunden, 720p, 16:9.
- Überprüfen Sie den Audio-Toggle. Ton ist standardmäßig aktiviert und erhöht den Preis pro Sekunde.
- Lesen Sie den Run-Button. Er zeigt die genauen Kosten Ihrer aktuellen Einstellungen. Bei den Standardwerten sind das 0,30 $, also decken 10 $ etwa 33 Läufe.
- Ausführen, überprüfen, herunterladen. Iterieren Sie am Prompt, bis die Ausgabe überzeugt, dann übertragen Sie diese genaue Konfiguration in Code.
Methode 2: Rufen Sie die PixVerse V6 API aus Code auf
Der PixVerse V6 Entwickler-Workflow auf Atlas Cloud besteht aus zwei HTTP-Anfragen.
Schritt 1: Holen Sie sich Ihren API-Schlüssel. Erstellen Sie einen Schlüssel in der Atlas Cloud-Konsole und speichern Sie ihn als Umgebungsvariable, niemals im Client-Code.
Bild: Screenshot der API-Schlüsselseite der Atlas Cloud-Konsole, die den Create-Key-Button und einen frisch generierten Schlüssel neben seinem Kopiersteuerelement zeigt.
Schritt 2: Überprüfen Sie die API-Dokumentation. Endpunkte, Parameter und Authentifizierung befinden sich in der API-Dokumentation.
Schritt 3: Stellen Sie Ihre erste Anfrage. Reichen Sie den Job ein:
plaintext1curl -X POST https://api.atlascloud.ai/api/v1/model/generateVideo \ 2 -H "Content-Type: application/json" \ 3 -H "Authorization: Bearer $ATLASCLOUD_API_KEY" \ 4 -d '{ 5 "model": "pixverse/v6/text-to-video", 6 "prompt": "A slow dolly shot through a rain-wet night market, neon signs reflecting in puddles, steam rising from food stalls", 7 "duration": 5, 8 "quality": "720p", 9 "aspect_ratio": "16:9", 10 "sound": true 11 }'
Die Antwort gibt eine Vorhersage-ID zurück. Pollen Sie, bis der Status completed lautet:
plaintext1curl https://api.atlascloud.ai/api/v1/model/prediction/<prediction_id> \ 2 -H "Authorization: Bearer $ATLASCLOUD_API_KEY"
Die abgeschlossene Antwort enthält die gehostete Video-URL. Der bleibende Vorteil ist die Anfrageform: Atlas Cloud führt eine API über jedes Modell aus, sodass ein Schlüssel, ein Auth-Header und eine Submit-and-Poll-Schleife sowohl PixVerse heute als auch alles, was Sie später hinzufügen, abdecken. Das Wechseln von Modellen bedeutet, die Modellzeichenfolge zu ändern, sonst nichts.
In der offiziellen PixVerse AI API-Dokumentation: Wie ein Aufruf tatsächlich abläuft
Wenn Sie stattdessen mit PixVerses eigener Plattform integrieren, definiert der API-Überblick einen dreistufigen Ablauf gegen die Basisdomain app-api.pixverse.ai:
| Stufe | Endpunkt | Notizen |
|---|---|---|
| Hochladen (nur Bild-zu-Video) | POST /openapi/v2/image/upload | Multipart-Formular. PNG, WebP oder JPEG unter 20 MB. Gibt eine img_id integer zurück |
| Generieren | POST /openapi/v2/video/text/generate | JSON-Body. Gibt eine video_id zurück |
| Pollen | GET /openapi/v2/video/result/{video_id} | Status 1 bedeutet fertig, mit einer Download-URL in der Antwort |
Die Authentifizierung erfordert zwei Header bei jedem Aufruf. API-KEY enthält den Schlüssel aus Ihrer Plattform-Konsole. Ai-trace-id muss eine frische UUID pro Anfrage sein; die Dokumentation warnt davor, dass die Wiederverwendung einer solchen das Starten neuer Generierungen blockiert.
Die aktuelle Text-zu-Video-Referenz markiert fünf Felder als erforderlich: prompt (bis zu 5.000 Zeichen), model, duration, quality und aspect_ratio. Die Modell-Enumeration akzeptiert acht Werte, v3.5 bis v5.6 plus v6 und c1, und die Dauerbegrenzungen folgen der Generation: 5 oder 8 Sekunden bis v5, eine 10-Sekunden-Option bei v5.5 und v5.6, und beliebig 1 bis 15 Sekunden bei v6 und c1. Audio ist optional über generate_audio_switch, der standardmäßig auf false gesetzt ist. Dieser Standardwert ist wichtig für die Budgetierung: Der Atlas Cloud-Playground oben setzt Sound standardmäßig auf an, sodass die beiden Routen unterschiedliche Preise für den scheinbar gleichen Clip nennen.
Bild-zu-Video fügt zuerst den Upload-Schritt hinzu. Es gibt keine Übergabe einer öffentlichen Bild-URL; Sie laden die Datei hoch, nehmen die zurückgegebene img_id und referenzieren sie im Generierungs-Body.
Zwei operative Fakten runden das Bild ab, beide aus der Fehlerreferenz. Gleichzeitige Generierungen sind durch die Mitgliedschaftsstufe begrenzt, und ein festsitzender Slot gibt sich nach etwa 10 Minuten frei. Und Poll-Status sollten explizit behandelt werden: 7 bedeutet, dass der Prompt die Inhaltsmoderation ausgelöst hat, 8 bedeutet einen Server-seitigen Fehler, der einen Wiederholungsversuch wert ist.
Wo die PixVerse-API-Dokumentation sich selbst widerspricht
Die PixVerse-API-Dokumentation ist eine Mischung aus aktuellen Endpunkt-Referenzen und älteren How-to-Seiten, die nie vollständig aktualisiert wurden. Das Lesen der falschen Seite kostet echte Debugging-Zeit. Die Konflikte, die wir direkt überprüft haben:
| Thema | Eine ältere Dokumentationsseite sagt | Die aktuelle Referenz sagt |
|---|---|---|
| negative_prompt | Wird in den Beispiel-Anforderungs-Body des API-Überblicks gezeigt | Kein Feld auf dem Generierungs-Endpunkt |
| water_mark | "water_mark": false erscheint in denselben Beispielen | Fehlt in der aktuellen Parameterliste |
| Clip-Länge | MCP README kodiert hart "5s or 8s" | Beliebig 1 bis 15 Sekunden bei v6 und c1 |
| Bild-Upload-Grenze | Troubleshooting-Seite: 4000×4000 Pixel | Upload-Referenz: 10.000 Pixel |
| Prompt-Länge | How-to-Leitfaden: Prompts zwischen 25 und 200 Wörtern halten | Harte Obergrenze von 5.000 Zeichen, keine Wortvorgabe |
Zwei Regeln decken alle fünf Zeilen ab. Wenn Seiten sich widersprechen, vertrauen Sie der Endpunkt-Referenz über der How-to-Seite; die Referenzen tragen aktuelle Spezifikationen, die Leitfäden tragen Geschichte. Und wenn Grenzen sich widersprechen, codieren Sie auf die strengere, also 4000 Pixel bei Uploads.
Die Versions-Enumeration verdient eine eigene Warnung. Alte Modellnamen funktionieren immer noch: v3.5, v4 und v4.5 bleiben gültige Werte, daher sind Integrationen aus dem Jahr 2025 nicht kaputt gegangen. Sie zahlen nur zu viel. Bei 720p für 5 Sekunden ohne Audio berechnet die offizielle Preisgestaltung 60 Credits auf V4, aber 45 auf V6. Wenn Sie eine Codebasis mit einer alten Modellzeichenfolge erben, ist das Upgrade eine einzeilige Änderung, die Kosten senkt und die Ausgabe verbessert. Nur die V2-Generation ist vollständig aus dem Erstanbieter-Zugriff verschwunden.
PixVerse-API-Preise: Credits auf der Plattform, Dollar auf Atlas Cloud
Die offizielle PixVerse-Plattform rechnet in Credits ab, und ihre Preisseite beschriftet die Modelltabellen "Berechnet pro Sekunde." Credit-Pakete reichen von 10 $ für 1.000 Credits bis zu 5.000 $ für 500.000, mit monatlichen Mitgliedschaften vom 100 $-Essential-Plan (15.000 Credits) bis zur 6.000 $-Business-Stufe. Der Credit-Verbrauch pro Sekunde für die aktuellen Modelle:
| Qualität | V6 (ohne Audio / mit Audio) | C1 (ohne Audio / mit Audio) |
|---|---|---|
| 360p | 5 / 7 Credits | 6 / 8 Credits |
| 540p | 7 / 9 Credits | 8 / 10 Credits |
| 720p | 9 / 12 Credits | 10 / 13 Credits |
| 1080p | 18 / 23 Credits | 19 / 24 Credits |
Atlas Cloud misst dieselben beiden Modelle in Dollar pro Sekunde, kein Paket oder Mitgliedschaft zuerst. Verifiziert auf den Live-Modellseiten am 23. Juli 2026, zum Listenpreis ohne laufenden Rabatt:
| Qualität | V6 (ohne Audio / mit Audio) | C1 (ohne Audio / mit Audio) |
|---|---|---|
| 360p | 0,025 $ / 0,035 $ | 0,030 $ / 0,040 $ |
| 540p | 0,035 $ / 0,045 $ | 0,040 $ / 0,050 $ |
| 720p | 0,045 $ / 0,060 $ | 0,050 $ / 0,065 $ |
| 1080p | 0,090 $ / 0,115 $ | 0,095 $ / 0,120 $ |
Ein Clip macht den Vergleich konkret. Ein 5-Sekunden-720p-V6-Clip mit Audio kostet 60 Credits: das sind 0,60 $ zum 10 $-Paketpreis oder etwa 0,40 $ zum Essential-Mitgliedschaftssatz, nachdem Sie 100 $ für den Monat ausgegeben haben. Gemessen auf Atlas Cloud kostet der identische Clip 0,30 $. Das C1-Modell ist pro Sekunde etwas teurer, 0,325 $ für denselben Clip über den C1-Playground, was seine Filmproduktions-Abstimmung erkauft.
Credits sind immer noch sinnvoll für Teams, die bereits innerhalb der PixVerse-Plattform arbeiten, insbesondere bei Scale-Tier-Volumen, wo der effektive Satz sinkt. Für alle anderen ist die Preisgestaltung pro Sekunde in Dollar einfacher zu prognostizieren: Der Preis eines Renderings ist Dauer mal Satz, lesbar bevor Sie ausgeben.
Das PixVerse AI Developer Company hinter der API
Eine API ist eine Wette auf das Unternehmen, das sie betreibt, und das Unternehmen hinter dem PixVerse AI Developer ist es wert, bekannt zu sein, bevor Sie bauen. PixVerse wird von AISphere (Aishi Technology) entwickelt, gegründet im April 2023 in Peking und jetzt mit Hauptsitz in Singapur mit etwa 150 Mitarbeitern. Gründer und CEO Wang Changhu leitete von 2017 bis 2021 die Vision-Arbeit des ByteDance AI Lab, was PixVerse zu einem direkten Rivalen von Seedance macht, das von seinem ehemaligen Arbeitgeber gebaut wurde. Mitgründer Jaden Xie kam von Lighthouse Capital.
Die Finanzierungssituation ist für eine unabhängige Videomodell-Werkstatt ungewöhnlich stark. Am 13. Juli 2026 schloss das Unternehmen eine Series-C-Erweiterung ab, die die Runde auf 439 Millionen Dollar bei einer Bewertung von über 2 Milliarden Dollar brachte, mit Alibaba an Bord, laut TechCrunch. Für einen Entwickler bedeutet das Runway: Die API, die Sie in diesem Quartal integrieren, wird im nächsten Jahr wahrscheinlich nicht verschwinden.
Die Kehrseite eines gut finanzierten Labors ist die Liefergeschwindigkeit. Die Release-Linie 2026 allein:
Drei Modellstarts innerhalb von drei Monaten erklären die Dokumentationsverzögerung, die dieser Artikel immer wieder anspricht. Bauen Sie entsprechend: Fixieren Sie Ihre Modellzeichenfolge, lesen Sie die Versionshinweise, bevor Sie sie aktualisieren, und überprüfen Sie die Endpunkt-Referenz erneut, anstatt anzunehmen, dass die Parameter des letzten Quartals überlebt haben.
Häufig gestellte Fragen
Wo ist die offizielle PixVerse-API-Dokumentation?
Unter docs.platform.pixverse.ai, mit der Entwicklerkonsole unter platform.pixverse.ai. Alles, was auf app.pixverse.ai gehostet wird, ist das Consumer-Produkt, und Drittanbieter-Seiten mit "PixVerse API docs" beschreiben häufig Parameter aus der v4-Ära. Die Dokumentation enthält auch eine konsolidierte LLM-bereite Textseite, die Sie einem Coding-Assistenten füttern können.
Wie bekomme ich einen PixVerse-API-Schlüssel?
Registrieren Sie sich in der Plattformkonsole unter platform.pixverse.ai, erstellen Sie einen Schlüssel und übergeben Sie ihn im API-KEY-Header zusammen mit einer eindeutigen Ai-trace-id UUID pro Anfrage. Schlüssel sind an Plattform-Credits gebunden, die separat von jedem Consumer-App-Abonnement gekauft werden. Auf Atlas Cloud ist das Äquivalent ein Konsolenschlüssel, der als Standard-Bearer-Token übergeben wird.
Hat die PixVerse-API einen kostenlosen Tarif?
Die Plattform-Preisdokumentation listet nur bezahlte Credit-Pakete und Mitgliedschaften auf. Die variablen täglichen kostenlosen Credits, die PixVerse bewirbt, gehören zur Consumer-App und fließen nicht in das API-Konto. Die günstigsten kostenpflichtigen Einstiegspunkte sind ein 10 $-Credit-Paket auf der offiziellen Plattform oder gemessene Generierung ab 0,025 $ pro Sekunde auf Atlas Cloud.
Welche Modelle kann die PixVerse-API ausführen?
Der aktuelle Generierungs-Endpunkt akzeptiert acht Modellwerte: v3.5, v4, v4.5, v5, v5.5, v5.6, v6 und c1. V6 und C1 sind die aktuelle Generation, mit 1 bis 15 Sekunden langen Clips und optionalem nativen Audio. Ältere Namen funktionieren immer noch, kosten aber mehr Credits bei denselben Einstellungen als V6. Die V2-Generation ist nicht mehr von Erstanbietern verfügbar.
Wie viel kostet die PixVerse AI API pro Video?
Offizielle Plattform: Ein 5-Sekunden-720p-V6-Clip mit Audio kostet 60 Credits, etwa 0,60 $ zum 10 $-Paketpreis. Atlas Cloud: Derselbe Clip kostet gemessen 0,30 $, aus einem Bereich pro Sekunde von 0,025 $ bis 0,115 $ je nach Auflösung und Audio. C1 ist etwas teurer, 0,325 $ für diesen Clip. Preise verifiziert am 23. Juli 2026.
Fazit
Die PixVerse-API ist in einem besseren Zustand als ihre Dokumentation. Der Dienst selbst ist schnell, gut finanziert und aktuell: acht Modellwerte, Clips bis zu 15 Sekunden, Audio im selben Durchlauf und ein asynchroner Ablauf, den jeder Junior-Entwickler an einem Nachmittag verdrahten kann. Die Dokumentation hat nur nicht mit dem Release-Kalender Schritt gehalten, sodass die Endpunkt-Referenzen und die How-to-Leitfäden unterschiedliche Produkte beschreiben.
Die Arbeitsmethode ist einfach. Vertrauen Sie der Endpunkt-Referenz, codieren Sie auf die strengere Grenze, wenn Seiten sich widersprechen, und fixieren Sie Ihre Modellzeichenfolge. Dann wählen Sie Ihre Abrechnungsform: Credits auf der offiziellen Plattform, wenn Ihr Team bereits dort arbeitet, oder Dollar pro Sekunde ab 0,025 $, wenn Sie den Preis jedes Renderings lesbar haben möchten, bevor Sie es senden. Der Standardclip für 0,30 $ im Playground ist ein günstiger Ort, um herauszufinden, auf welcher Seite Sie stehen.
