APIMaster.ai

Vidu Image Q2 · API-Referenz

Vidu Image Q2 erzeugt Bilder aus Text oder mit Referenzbildern. Die Anleitung zeigt, wie man Aufgaben abfragt und Ergebnisse herunterlädt.

Erstellen Sie eine Aufgabe mit POST /v1/wand/vidu-image/generation und fragen Sie sie mit GET /v1/wand/vidu-image/tasks/{task_id} ab. Senden Sie einen APIMaster API-Schlüssel im Authorization: Bearer Header mit beiden Anfragen. Der POST-Anfragekörper hat das Format JSON.

Feld Typ Beschreibung
model string Erforderlich. Verwenden Sie vidu-image-q2.
prompt string Erforderlich. Bis zu 2,000 Zeichen. Für die Bilderzeugung aus Text lassen Sie die Referenzbilder weg (text-to-image).
images string[] Optional. Bis zu sieben öffentliche URLs oder Daten-URIs in PNG, JPEG/JPG oder WebP. Jedes Bild muss mindestens 128 × 128 Pixel groß sein. Das Seitenverhältnis muss zwischen 1:4 und 4:1 liegen. Pro Bild sind bis zu 50 MB zulässig, für den gesamten Anfragekörper bis zu 20 MB.
aspect_ratio string 16:9 standardmäßig. Die Optionen sind 16:9, 9:16, 1:1, 3:4, 4:3, 21:9, 2:3, 3:2 und auto. Die Einstellung auto folgt dem ersten Referenzbild.
resolution string 1080p standardmäßig. Unterstützt auch 2K und 4K. Groß- und Kleinschreibung beachten.
seed integer Für einen zufälligen Startwert das Feld weglassen oder auf 0 setzen.
curl -X POST "https://apimaster.ai/v1/wand/vidu-image/generation" \
  -H "Authorization: Bearer $APIMASTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"vidu-image-q2","prompt":"A blue circle on a white background","resolution":"1080p"}'

Fragen Sie den Status alle 3–5 Sekunden mit der zurückgegebenen task_id und demselben Konto ab. Mögliche Zustände sind created, queueing, processing, success und failed. Laden Sie die Dateien bei Erfolg unter creations[].url innerhalb von 12 Stunden herunter. Verwenden Sie request_id, um Fehler wie ungültige Bilder, Inhaltsüberprüfung, unzureichende Gutschrift, Anfragelimits oder fehlende Aufgaben zu verfolgen.

Statusabfragen lösen weder eine neue Generierung noch eine erneute Abbuchung aus. callback_url wird nicht unterstützt. Um eine verlorene Einreichung wiederherzustellen, senden Sie eine stabile Idempotency-Key von 8–128 sichtbaren ASCII Zeichen und folgen Sie der Anleitung zur Wiederherstellung einer Anfrage. 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.

tokenhub_usage.total_tokens berichtet über die billbare Nutzung, die von der Auflösung und wie viele Referenzen verwendet wurden. Siehe Vidu Image Q2 Modellkarte für den aktuellen APIMaster Preis.