Vidu Q3 Pro API：540p・音声付き

Name: Vidu Q3 Pro API
SKU: vidu/q3-pro/image-to-video
Price: 0.41 USD
Availability: InStock

リクエストパラメーター

パラメーター	必須	説明
`bgm`	いいえ	Add a background music bed that fits the scene. デフォルト: true
`duration_seconds`	いいえ	動画の長さ。1秒ごとに課金されます。 ≥ 1 · ≤ 16 · デフォルト: 5
`generate_audio`	いいえ	映像に合った音（声、環境音、効果音）を付けます。デフォルト: true
`image_url`	はい	出発点になる画像。
`movement_amplitude`	いいえ	被写体とカメラの動きの大きさ。 auto · small · medium · large · デフォルト: auto
`prompt`	はい	Describe what happens after the opening frame: the action, the camera, and the mood.
`resolution`	いいえ	出力サイズ。大きいほど鮮明で、料金も上がります。 540p · デフォルト: 540p
`seed`	いいえ	同じ数字を使えば、同じ結果を再現できます。 ≥ 0 · ≤ 2147483647

料金

料金はクレジットで表示され、サイトで使うクレジットと同じです（1クレジット = $0.01）。タスクの受付時に保留され、完了時に実際の料金で精算されます。失敗したタスクは返金されます。

オプション	クレジット /秒	≈ USD
標準	8.1	$0.081

タスクごとにクレジットは整数に切り上げられるため、最安の設定で 1 回実行すると 41クレジット/ 5秒の動画（$0.41）です。

実行前に正確な金額を知りたいときは、同じボディを POST /jobs/quote に送ってください。

API クイックスタート

Vidu Q3 Pro API を 3 ステップで呼び出す

API キーを作成する. PopNow にログインし、API コンソールでキーを作成します。キーは sk-popnow- で始まり、サイトと同じクレジットを使います。
リクエストを送る. POST /jobs/createTask に、model を vidu/q3-pro/image-to-video、input をパラメーター表どおりにして送ります。レスポンスですぐにタスク ID が返ります。
結果を受け取る. タスク ID で GET /jobs/recordInfo をポーリングするか、callBackUrl を渡せば結果がそこへ送られます。タスクが成功したら出力リンクからダウンロードします。

# 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-pro/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",
    "movement_amplitude": "auto",
    "duration_seconds": 5,
    "resolution": "540p"
  }
}'

# 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"

プロンプトとリンクはご自身のものに置き換えてください。API タブにレスポンス、ポーリング、コールバックのリファレンスがあります。