PixVerse V6.0 / C1 · API-Referenz
Generieren von PixVerse-Videos aus Text, Bildern, Start- und Endframes oder Referenzen.
Verwenden Sie pixverse-video-v6.0 oder pixverse-video-c1 als Modell-ID. Senden Sie JSON mit einem APIMaster API-Schlüssel im Authorization: Bearer Header.
| Aufruf | Endpunkt |
|---|---|
| Text-to-video | POST /v1/wand/pixverse/text-to-video |
| Image-to-video | POST /v1/wand/pixverse/image-to-video |
| Start/End-Frames | POST /v1/wand/pixverse/start-end-to-video |
| Reference-to-video | POST /v1/wand/pixverse/reference-to-video |
| Aufgabenstatus | GET /v1/wand/pixverse/tasks/{task_id} |
| Feld | Typ | Beschreibung |
|---|---|---|
model |
string | Erforderlich. Verwenden Sie eine der obigen Modell-IDs. |
prompt |
string | Erforderlich, bis zu 5,000 Zeichen. Referenzaufforderung kann @ref_name verwenden. |
duration |
integer | 1–15 Sekunden, auch bei 1080p. Der Standardwert ist 5 Sekunden. |
quality |
string | Erforderlich. 360p, 540p, 720p oder 1080p. |
aspect_ratio |
string | Nur Text-to-video und reference-to-video. 16:9 (Standard), 4:3, 1:1, 3:4, 9:16, 2:3, 3:2 oder 21:9. Andere Routen folgen dem Eingabebild. |
seed |
integer | Von 0 bis 2,147,483,647. Für einen zufälligen Startwert das Feld weglassen oder auf 0 setzen. |
generate_audio_switch |
boolean | Setzen Sie true für Audio. Standardwert: false. |
camera_movement |
string | Optionale Bewegung wie zoom_in, für text-to-video und image-to-video. |
generate_multi_clip_switch |
boolean | Optional für V6.0 text-to-video und image-to-video. Standardwert: false. |
img_id |
string | Erforderlich für image-to-video. Öffentliches Bild URL oder Base64. |
img_ids |
string[] | Reserviert für eine image-to-video Multi-Image-Vorlage. Eine Standard image-to-video Anfrage verwendet img_id. |
first_frame_img, last_frame_img |
string | Erforderlich für Start/Endframe-Anfragen. Verwenden Sie öffentliche URLs oder Base64. Passende Seitenverhältnisse verwenden. |
image_references |
object[] | Erforderlich für reference-to-video. Bis zu sieben Elemente mit img_id, optional type (subject oder background) und ref_name mit bis zu 30 Zeichen. |
curl -X POST "https://apimaster.ai/v1/wand/pixverse/text-to-video" \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"pixverse-video-v6.0","prompt":"A slow pan across a mountain lake","duration":5,"quality":"720p"}'
Erfordert ErrCode=0 sowie einen erfolgreichen HTTP Status. Die Antwort enthält ErrMsg, Resp.video_id und request_id. Umfragen Sie alle 3–5 Sekunden mit dem gleichen Konto. Resp.status ist 1 für den Erfolg, 5 für die Verarbeitung, 6 für den gelöschten, 7 für den Inhaltsüberprüfungsfehler und 8 für den Erzeugungsausfall. Resp.url ist der letzte temporäre Download URL und hält bis zu 12 Stunden. Die Antwort kann auch Dimensionen, Größe, Samen, Stil und Zeitstempel enthalten.
Statusabfragen lösen weder eine neue Generierung noch eine erneute Abbuchung aus. Verwenden Sie ein Idempotency-Key von 8–128 sichtbaren ASCII Zeichen, um eine Einreichung wiederherzustellen. Mit demselben Schlüssel und identischen Parametern erhalten Sie einen Wiederherstellungsbeleg mit HTTP 202. Abweichende Parameter mit demselben Schlüssel führen zu HTTP 409. Siehe Anleitung zur Wiederherstellung einer Anfrage. Die API akzeptiert keinen negativen Prompt-Parameter oder callback_url.
tokenhub_usage.total_tokens meldet eine billbare Nutzung. Auflösung und Audio-Einstellungen beeinflussen den Preis. Siehe PixVerse V6.0 und PixVerse C1 Modellkarten für aktuelle APIMaster Preise.
