Vidu Q3 Pro API

Vidu Q3 Pro ist die Pro-Stufe der Q3-Videoreihe von Vidu und steht als einzelner Bild-zu-Video-Endpunkt bereit. Sie senden ein Startbild in image_url und eine Anweisung in prompt – beides ist Pflicht – und erhalten 1 bis 16 ganze Sekunden Video in 540p, mit Ton aus demselben Durchgang. Das Bild legt Motiv, Look und die Form der Ausgabe fest; ein Feld für das Seitenverhältnis gibt es nicht, und das Verhältnis des Bildes selbst muss zwischen 1:4 und 4:1 liegen. Der Prompt muss also nur beschreiben, was sich bewegt.

Eine Auflösung – entschieden wird nur die Länge

resolution akzeptiert einen einzigen Wert, 540p, und jeder Clip kommt in dieser Größe zurück. Damit bleibt duration_seconds – jede ganze Zahl von 1 bis 16, Standard 5 – die Einstellung, die sowohl die Länge des Clips als auch den Preis verändert; die Live-Schätzung folgt ihr, während Sie den Wert verschieben.

Die Identität kommt aus dem Standbild

Motiv, Kleidung, Bildausschnitt und Ausgabeform werden vom Bild bestimmt, nicht vom Prompt. Zwei Läufe mit demselben Bild unterscheiden sich in der Bewegung, nicht darin, wer zu sehen ist – deshalb lässt sich eine Serie von Clips aus einem Standbild zusammenschneiden. Zugleich kann die Videoanfrage nichts überschreiben, was im Bildschritt freigegeben wurde.

Bewegung beschreiben, dann die Menge einstellen

movement_amplitude legt die Bewegungsmenge insgesamt fest – standardmäßig auto, sonst small, medium oder large –, der Prompt sagt, was sich wie bewegt. Bewegt sich ein Take zu viel oder zu wenig, halten Sie seed und Bild fest und formulieren Sie nur die Bewegung um – eine kleinere Drehung, ein langsamerer Gang –, damit der sichtbare Unterschied aus genau dieser einen Änderung stammt und nicht aus einem neuen Zufallslauf.

Reaktionsserien für eine Figur

Aus einem Kostümbild werden ein Zwinkern, ein Winken, ein Kopfneigen und eine Drehung – vier Anfragen mit demselben Bild und vier verschiedenen Prompts. Weil das Bild die Identität festlegt, lässt sich die Serie zusammenschneiden, ohne dass jemand zwischen den Clips abweicht.

Nahe, rhythmische Handlung

Das Schmiede-Beispiel bleibt sechs Sekunden lang dicht an Brust und Unterarmen eines Schmieds, von unten vom Feuer beleuchtet, und bei jedem Hammerschlag sprühen Funken. Wiederholte Schläge sind ein nützlicher Test für diesen Endpunkt: Die Funken müssen auf den Schlägen landen, nicht dazwischen.

Hochformatige Lieferungen

Exportieren Sie das Standbild in 9:16, und der Clip kommt hochkant zurück. Im Unterführungs-Beispiel trägt der Prompt nur den Gang unter den Leuchtstoffröhren auf das Objektiv zu und eine Kamera, die im gleichen Tempo vor ihr zurückweicht; das Hochformat wurde im Bildschritt entschieden.

Unzensierte Szenen aus Ihrem eigenen Bild

Ihr Standbild wird so animiert, wie es geliefert wurde, statt abgeschwächt zu werden. Da das Bild den Inhalt trägt, bleibt das Ergebnis nah an dem, was freigegeben wurde. Vidu Q3 Spicy aus derselben Reihe ist die per LoRA abgestimmte, unzensierte Variante.

# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
  -d '{
  "model": "vidu/q3-pro/image-to-video",
  "input": {
    "duration_seconds": 5,
    "image_url": "https://example.com/reference.png",
    "movement_amplitude": "auto",
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "resolution": "540p"
  }
}'

# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

Authentifizierung, vollständiges Schema, Polling und Fehlerbehandlung stehen in der API-Referenz.