メインコンテンツへスキップ
POST
/
v1
/
tasks
curl -X POST https://qingbo.dev/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "viduq3",
    "action": "generate",
    "prompt": "城市夜景延时摄影，霓虹灯光流转",
    "aspect_ratio": "16:9",
    "duration": 5,
    "resolution": "1080p"
  }'

{
  "task_id": "task-wave1775285160b950328499",
  "model": "viduq3",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}
非同期処理モード — リクエスト送信後にタスク ID が返されます。タスクステータス照会 インターフェースで生成結果を取得してください。動画リンクの有効期限は24時間です。 
curl -X POST https://qingbo.dev/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "viduq3",
    "action": "generate",
    "prompt": "城市夜景延时摄影，霓虹灯光流转",
    "aspect_ratio": "16:9",
    "duration": 5,
    "resolution": "1080p"
  }'

{
  "task_id": "task-wave1775285160b950328499",
  "model": "viduq3",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}

​
利用可能なモデル

モデル ID説明
viduq3Vidu Q3、ネイティブ音声・16秒・1080p
viduq3-proVidu Q3 Pro、最高画質
viduq3-turboVidu Q3 Turbo、速度優先
viduq3-mixVidu Q3 Mix、複数参照画像・複数エンティティの一貫性
viduq2Vidu Q2
viduq1Vidu Q1

​
統一パラメータ

​
model
string
必須
モデル ID
​
action
string
デフォルト:"generate"
操作タイプ
​
prompt
string
必須
動画の説明テキスト
​
aspect_ratio
string
デフォルト:"16:9"
アスペクト比：16:9、9:16、1:1
​
duration
integer
デフォルト:"5"
動画の長さ（秒）
​
resolution
string
デフォルト:"1080p"
解像度：720p、1080p
​
seed
integer
ランダムシード、0 はランダム
​
watermark
boolean
透かしを追加するかどうか。カスタム透かし画像と位置にも対応（extra 経由）
​
image_urls
string[]
参照画像 URL 配列、枚数により生成モードが決まります：
  • 1枚 → 画像から動画
  • 2枚 → 先頭末尾フレームモード
  • 3枚以上 → 参照画像ガイド（自動的に viduq2 に切り替え）
​
callback_url
string
Webhook コールバックアドレス
​
extra
object
パススルーパラメータ

​
モデル固有のパラメータ

​
extra.movement_amplitude
string
デフォルト:"auto"
動きの幅：auto、small、medium、large
​
extra.bgm
boolean
デフォルト:"false"
BGM を追加するかどうか
​
extra.wm_url
string
カスタム透かし画像 URL（watermark: true が必要）
​
extra.wm_position
integer
透かし位置：1（左上）、2（右上）、3（左下）、4（右下）

​
生成モード

モードパラメータ説明
テキストから動画promptテキストのみで生成
画像から動画prompt + image_urls(1枚)単一画像参照
先頭末尾フレームimage_urls(2枚)開始・終了画面の遷移
参照画像ガイドimage_urls(3枚以上)複数画像参照（自動的に viduq2 に切り替え）

​
レスポンス

​
task_id
string
タスク ID
​
model
string
使用されたモデル ID
​
action
string
操作タイプ
​
status
string
タスクステータス：queued
​
created_at
integer
作成時間（Unix ミリ秒タイムスタンプ）
​
progress
integer
進捗、初期値は 0