Diese Anleitung gibt es vorerst nur auf Englisch. →
Anfrageparameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
bgm | Nein | Add background music to the clip. Separate from generate_audio, which covers the sound of the scene itself. Standardwert: true |
duration_seconds | Nein | Wie lang der Clip läuft. Abgerechnet wird pro Sekunde. ≥ 1 · ≤ 16 · Standardwert: 5 |
generate_audio | Nein | Fügt passenden Ton hinzu: Stimmen, Atmo und Effekte. Standardwert: true |
image_url | Ja | Das Bild, von dem aus es losgeht. |
movement_amplitude | Nein | Wie stark sich Motiv und Kamera bewegen. auto · small · medium · large · Standardwert: auto |
prompt | Ja | Describe what happens after the opening frame: the action, the camera, and the mood. |
resolution | Nein | Ausgabegröße. Größere Formate sind schärfer und kosten mehr. 540p · 720p · 1080p · Standardwert: 720p |
seed | Nein | Dieselbe Zahl liefert ein wiederholbares Ergebnis. ≥ 0 · ≤ 2147483647 |
Preise
Die Preise sind in Credits angegeben, denselben Credits, die du auf der Website nutzt (1 Credit = 0,01 $). Beim Annehmen der Aufgabe wird der Betrag reserviert und nach Abschluss auf die tatsächlichen Kosten abgerechnet; fehlgeschlagene Aufgaben werden erstattet.
| Option | Credits pro Sekunde | ≈ USD |
|---|---|---|
| resolution 540p | 10,5 | 0,11 $ |
| resolution 720p | 22,5 | 0,23 $ |
| resolution 1080p | 24 | 0,24 $ |
Jede Aufgabe wird auf ganze Credits aufgerundet, ein Lauf in der günstigsten Stufe kostet also 53 Credits für einen 5-Sekunden-Clip (0,53 $).
Für eine exakte Zahl vor dem Start sendest du denselben Body an POST /jobs/quote.
API-Schnellstart
Die Vidu Q3 API in drei Schritten aufrufen
- API-Schlüssel erstellen. Melde dich bei PopNow an und erstelle in der API-Konsole einen Schlüssel. Schlüssel beginnen mit sk-popnow- und nutzen dieselben Credits wie die Website.
- Anfrage senden. Sende POST /jobs/createTask mit model vidu/q3/image-to-video und einem input-Objekt nach der Parametertabelle. Die Antwort enthält sofort eine Task-ID.
- Ergebnis abholen. Frage GET /jobs/recordInfo mit der Task-ID ab oder gib eine callBackUrl mit, dann schicken wir das Ergebnis dorthin. Lade die Ausgabelinks herunter, sobald die Aufgabe erfolgreich ist.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "vidu/q3/image-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"duration_seconds": 5,
"resolution": "720p",
"movement_amplitude": "auto"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Ersetze den Prompt und alle Links durch deine eigenen. Im Tab „API“ findest du die Referenz zu Antwort, Polling und Callback.
Fragen zur Vidu Q3 API
Was kostet die Vidu Q3 API?
Vidu Q3 kostet 53 Credits (0,53 $) für einen 5-Sekunden-Clip. Preise nach Option: 540p 10,5 Credits pro Sekunde, 720p 22,5 Credits pro Sekunde, 1080p 24 Credits pro Sekunde. Die Credits sind dieselben wie auf der Website (1 Credit = 0,01 $), neue Konten bekommen 30 Gratis-Credits, und fehlgeschlagene Tasks werden erstattet.
Wie lautet der Modellname von Vidu Q3 in der API?
Trag vidu/q3/image-to-video für Bild zu Video im Feld model von POST /jobs/createTask ein.
Welche Auflösungen unterstützt Vidu Q3?
540p, 720p und 1080p, mit 720p als Standard. Verlässlich ist dieser Ablauf: die Bewegung in 540p finden und den freigegebenen Take dann mit demselben Startbild und demselben seed in 1080p nachfahren.
Kann ich allein aus Text generieren?
In dieser Familie nicht. Vidu Q3 ist nur als image-to-video veröffentlicht, jede Anfrage braucht also image_url. Wenn Sie von einer geschriebenen Idee ausgehen, rendern Sie das Startbild zuerst mit einem Bildmodell, geben es frei und animieren es dann hier.
Wie lege ich das Seitenverhältnis fest?
Über das hochgeladene Bild. Dieser Endpunkt hat keinen Seitenverhältnis-Parameter: Ein 16:9-Still ergibt einen 16:9-Clip, ein 9:16-Still einen Hochformat-Clip. Beschneiden Sie das Bild also, bevor Sie es senden.
Erzeugt es Ton?
Ja. generate_audio steht auf true, Raumklang und Foley kommen also synchron zum Bild. Setzen Sie es auf false für einen stummen Clip. Einen eigenen Schalter für eine Musikspur gibt es bei Q3-Modellen nicht – beschreiben Sie gewünschte Musik im Prompt.
Wie wird Vidu Q3 abgerechnet?
Nach Ausgabedauer, mit eingerechneter Auflösung. Die Live-Schätzung vor dem Absenden spiegelt exakt Dauer und Auflösung Ihrer Anfrage.
Welche Limits hat die Vidu Q3 API?
Cliplänge: 1–16 s; Auflösungen: 540p · 720p · 1080p. Anfragen außerhalb dieser Grenzen werden abgelehnt, bevor etwas abgebucht wird.
Kann ich Vidu Q3 testen, ohne Code zu schreiben?
Ja. Der Playground führt Vidu Q3 mit deinen PopNow-Credits aus, braucht keinen API-Schlüssel und zeigt dir zu jedem Lauf den passenden Code.
Alle Vidu-Modelle
Vidu Q4 Preview ergänzt Referenzszenen, Clip-Verlängerung und Ausgabe bis 4K und startet bei einem niedrigeren Preis pro Sekunde.
- Vidu Q4 Preview APIClips bis 4K mit Ton und gesprochenen DialogenAb 34 Credits für einen 5-Sekunden-Clip
- Vidu Q3 Turbo APISchnelle Bildanimation mit Ton, bis 16 SekundenAb 32 Credits für einen 5-Sekunden-Clip
- Vidu Q3 APIEin Bild bis zu 16 Sekunden in 1080p animierenAb 53 Credits für einen 5-Sekunden-Clip
- Vidu Q3 Pro APIBilder animieren, Ton standardmäßig an, bis 16 SekundenAb 41 Credits für einen 5-Sekunden-Clip

