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.
