APIMaster.ai

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.