Vidu Q3 Pro API-Referenz

Mit einem einzigen PopNow-API-Schlüssel rufst du Vidu Q3 Pro aus deinem eigenen Code auf. Hier findest du die Modell-IDs, jedes Eingabefeld, die Kosten pro Anfrage in Credits und eine Anfrage, die du direkt ins Terminal kopieren kannst.

Die Parameterbeschreibungen stammen aus dem Eingabeschema des Modells und sind nur auf Englisch verfügbar.

Auf einen Blick

Hersteller: Vidu
Ergebnis: Video
Ab: 8.1 Credits pro Sekunde Ergebnis ($0.081)
Typische Dauer: etwa 103 s
Modell-IDs: vidu/q3-pro/image-to-video

1 Credit = 0,01 $. Bei Annahme reserviert ein Task den höchstmöglichen Betrag und rechnet am Ende den tatsächlichen Verbrauch ab, auf ganze Credits aufgerundet; der Rest wird freigegeben. Fehlgeschlagene Tasks kosten nichts. Den genauen Betrag vorab liefert POST /api/v1/jobs/quote.

Bild zu Video

vidu/q3-pro/image-to-video

Preis

Option	Credits (pro Sekunde Ergebnis)	US-Dollar
`Standard`	8.1	$0.081

Parameter

Feld	Typ	Standardwert	Erlaubt	Bedeutung
`image_url`Pflicht	`string (uri)`	—	—	Opening frame. The clip starts from this image.
`prompt`Pflicht	`string`	—	—	Describe what happens after the opening frame: the action, the camera, and the mood.
`movement_amplitude`Optional	`string`	`auto`	auto, small, medium, large	How much things in the frame move.
`duration_seconds`Optional	`integer`	`5`	1 bis 16	Requested output length in seconds.
`resolution`Optional	`string`	`540p`	540p	Output resolution.
`generate_audio`Optional	`boolean`	`true`	—	Request synchronised output audio.
`bgm`Optional	`boolean`	`true`	—	Add a background music bed that fits the scene.
`seed`Optional	`integer`	—	0 bis 2147483647	Random seed. Keep it fixed only for controlled comparisons, not as a frame-identical guarantee.

Beispielanfrage

Diese Anfrage läuft so, wie sie ist; weggelassene Felder behalten ihren Standardwert. Leg deinen Schlüssel vorher in POPNOW_API_KEY ab.

Das Beispiel nutzt in image_url Beispieldateien von PopNow. Ersetze sie durch eigene öffentliche HTTPS-Links, Uploads oder gespeicherte Assets.

POST /api/v1/jobs/createTask

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: $(uuidgen)" \
  -d '{
  "model": "vidu/q3-pro/image-to-video",
  "input": {
    "prompt": "He lands softly on the rooftop, laughs and turns toward the camera while the balloons sway in the evening breeze; slow push-in",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "resolution": "540p",
    "duration_seconds": 5
  }
}'

Die Antwort enthält sofort eine taskId. Das Ergebnis holst du mit GET /api/v1/jobs/recordInfo ab – oder du gibst callBackUrl mit und wirst benachrichtigt.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"