Zum Hauptinhalt springen
POST
Dieser Endpunkt arbeitet asynchron. Verwenden Sie nach dem Absenden die zurückgegebene task_id mit GET /v1/videos/generations/{task_id}, um Status und Ergebnis abzufragen.

Modellfunktionen

PixVerse V6 Max ist die Version von PixVerse V6 mit höherer Bildqualität. Unterstützt werden nur Text-zu-Video und Video aus einem einzelnen Bild, jeweils mit dem Modellnamen pixverse-v6-max. Für Übergänge zwischen Start- und Endbild, die Kombination mehrerer Bilder und Videoverlängerung verwenden Sie PixVerse V6.

Anfrage-Header

string
erforderlich
Bearer-Authentifizierung: Bearer <token>, wobei <token> Ihr APIMart API Key ist.

Anfrageparameter

string
erforderlich
Muss pixverse-v6-max sein.
string
Beschreibung des zu generierenden Inhalts. Für Text-zu-Video erforderlich, maximal 5000 Zeichen; für Bild-zu-Video optional, maximal 2048 Zeichen.
string[]
Liste der Eingabebild-URLs. Bild-zu-Video akzeptiert genau 1 Bild; bei 2 oder mehr wird synchron HTTP 400 zurückgegeben. Für Text-zu-Video das Feld weglassen.Bilder müssen über HTTP(S) öffentlich erreichbar sein, im Format JPEG, PNG oder WebP vorliegen, kleiner als 20 MB sein und dürfen pro Seite maximal 10000 Pixel haben.
integer
Standard:"5"
Ausgabedauer in Sekunden: 1–15, Standardwert 5.
string
Standard:"540p"
Ausgabeauflösung: 360p, 540p, 720p oder 1080p; Standardwert 540p.Die Ausgabe verwendet die nativen Abmessungen des zugrunde liegenden Modells. Maßgeblich sind die tatsächlich zurückgegebenen Abmessungen. Beispiele aus Tests sind 640×360 und 1108×832 (Breite × Höhe in Pixeln).Auch quality wird akzeptiert. Wenn beide Felder angegeben sind, hat resolution Vorrang.
string
Kompatibilitätsfeld für die Auflösung mit denselben Werten wie resolution. Wird nur ohne resolution verwendet; fehlen beide Felder, gilt 540p.
string
Standard:"16:9"
Gilt nur für Text-zu-Video. Unterstützt 16:9, 9:16, 4:3, 3:4, 1:1, 2:3, 3:2 und 21:9; Standardwert 16:9.Bild-zu-Video folgt immer dem Seitenverhältnis des Eingabebilds; dieses Feld hat keine Wirkung.
boolean
Standard:"false"
true aktiviert die native Tonerzeugung; standardmäßig ist das Video stumm. Mit Ton gilt ein höherer Preis pro Sekunde.Nur audio auf der obersten Ebene des Anfragekörpers wird ausgewertet. metadata.generate_audio_switch aktiviert weder Ton noch den Audiotarif.
integer
Zufallsstartwert von 0 bis 2147483647.

Beispiel für Bild-zu-Video

Ersetzen Sie die Beispiel-URL durch eine echte, öffentlich erreichbare Bild-URL. Übergeben Sie nur 1 Bild; das Seitenverhältnis der Ausgabe folgt diesem Bild.

Aufgabe abfragen

Ersetzen Sie die Aufgaben-ID in der folgenden Anfrage durch die beim Absenden zurückgegebene task_id:

Abrechnung

Die Kosten ergeben sich aus Ausgabesekunden mal Sekundenpreis für die gewählte Auflösung und Audiostufe. Für Videos mit und ohne Ton gelten separate Preise; mit Ton ist der Sekundenpreis höher. Wenn weder resolution noch quality angegeben wird, verwenden Ausgabe und Abrechnung 540p. Aktuelle Preise liefert der Endpunkt für Modellpreise:

Nicht unterstützte Funktionen und Parameterfehler

Die folgenden Anfragen liefern synchron HTTP 400, ohne eine Aufgabe zu erstellen oder Kosten zu berechnen: