APIMaster.ai

Vidu Video Q4 Preview · API-Referenz

Generieren Sie ein Video aus einem einzigen Bild oder Referenzen, dann wählen Sie die APIMaster-Task aus.

Verwenden Sie POST /v1/wand/vidu/image-to-video für ein einzelnes Startbild oder POST /v1/wand/vidu/reference-to-video für eine referenzgeführte Generation. Umfrage mit GET /v1/wand/vidu/tasks/{task_id}. Verwenden Sie JSON für die Einreichung und Bearer Authentifizierung für jede Anfrage. Text-only-Generierung und ein separater Start/End-frame-Endpunkt sind für dieses Modell nicht verfügbar.

Feld Typ Beschreibung
model string Erforderlich. Verwenden Sie vidu-video-q4-preview.
images string[] Image-to-video benötigt genau ein Bild. Reference-to-video akzeptiert bis zu 15 Bilder oder subjects. Verwenden Sie öffentliche URLs oder Daten URIs in PNG, JPEG/JPG oder WebP. Das Aspektverhältnis muss 1:4 zu 4:1 sein. Jedes URL Bild kann bis zu 50 MB betragen. Base64 Bilder sind auf 15 MB vor der Kodierung und 20 MB kodiert insgesamt beschränkt.
subjects object[] Für reference-to-video als Alternative zu images. Setzen Sie die name und ein bis drei images. Ein Thema mit @name finden Sie in der Eingabeaufforderung.
prompt string Erforderlich für reference-to-video. Bis zu 2,000 Zeichen für direkte Bildreferenzen oder 5,000 für Probanden und image-to-video. Image-to-video ignoriert dieses Feld, wenn is_rec eingeschaltet ist.
auto_subjects boolean Option Fachbibliothek für reference-to-video. Standardwert: false.
audio boolean Standardwerte für true für image-to-video und false für reference-to-video. Referenzvideo mit Audio erfordert subjects und einen expliziten true Wert.
audio_type string Wenn Audio aktiviert ist, verwenden Sie all (Standard), speech_only oder sound_effect_only.
is_rec boolean Automatische Sofortempfehlung für image-to-video. Es zu aktivieren erhöht die Aufgabennutzung.
duration integer Von 3 zu 16 Sekunden, mit 5 als Standard.
resolution string 540p, 720p (Standard), 1080p, 2K oder 4K.
aspect_ratio string Nur Reference-to-video. Verwenden Sie 16:9 (Standard), 9:16, 3:4, 4:3 oder 1:1. Image-to-video folgt dem Eingabebild.
seed integer Für einen zufälligen Startwert das Feld weglassen oder auf 0 setzen.
payload string Optionale Anwendungsdaten, bis zu 1,048,576 Zeichen.
watermark boolean Standardwert: false.
wm_url string Optionales benutzerdefiniertes Wasserzeichen URL. Das Standard-Wasserzeichen erscheint oben links. Die API akzeptiert wm_position nicht.
curl -X POST "https://apimaster.ai/v1/wand/vidu/image-to-video" \
  -H "Authorization: Bearer $APIMASTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"vidu-video-q4-preview","images":["https://example.com/reference.jpg"],"prompt":"Slow camera pan","duration":5,"resolution":"720p"}'

Fragen Sie den Status alle 5–10 Sekunden mit der task_id und demselben Konto ab. Die Staaten sind created, queueing, processing, success und failed. Beim Erfolg ist creations[].url das Video und creations[].cover_url ist sein Cover. Download von temporären Links innerhalb von 12 Stunden. Halten Sie request_id, wenn Sie einen Fehler melden.

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. Abfrage-Timeouts können nachgeprobt werden, ohne ein neues Video zu erstellen.

Das Tor legt einmal die Generation ab. tokenhub_usage.total_tokens meldet eine billbare Nutzung. Siehe Vidu Video Q4 Preview Modellkarte für den aktuellen APIMaster Preis.