メインコンテンツへスキップ
POST
/
v1
/
tasks
curl -X POST https://qingbo.dev/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "hailuo-2.3",
    "action": "generate",
    "prompt": "一只白猫慵懒地躺在阳光下的窗台上",
    "duration": 6,
    "resolution": "1080p"
  }'

{
  "task_id": "task-wave1775285160b950328499",
  "model": "hailuo-2.3",
  "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": "hailuo-2.3",
    "action": "generate",
    "prompt": "一只白猫慵懒地躺在阳光下的窗台上",
    "duration": 6,
    "resolution": "1080p"
  }'

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

​
利用可能なモデル

モデル IDデフォルト解像度対応する長さ説明
hailuo-2.3768P6秒 / 10秒Hailuo 2.3、4K・キャラクター参照に対応
hailuo-2.3-fast768P6秒 / 10秒Hailuo 2.3 高速版
hailuo-02768P6秒 / 10秒Hailuo 02、先頭末尾フレームに対応
T2V-01-Director768P6秒ディレクターモード、カメラ構文制御に対応
I2V-01-Director720P6秒画像から動画ディレクターモード
S2V-01720P6秒キャラクター参照モード、キャラクターの一貫性を維持

​
統一パラメータ

​
model
string
必須
モデル ID
​
action
string
デフォルト:"generate"
操作タイプ
​
prompt
string
必須
動画の説明テキスト
​
duration
integer
デフォルト:"6"
動画の長さ（秒）：6、10
​
resolution
string
デフォルト:"768p"
出力解像度、選択可能な値はモデルにより異なります。各モデルの Tab を参照
​
image_urls
string[]
先頭フレーム画像 URL、画像から動画生成に使用
​
last_frame
string
末尾フレーム画像 URL、image_urls と併用が必要。hailuo-02 のみ対応
​
callback_url
string
Webhook コールバックアドレス
​
extra
object
Hailuo にパススルーされる追加パラメータ、各モデルの Tab を参照

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

resolution の選択可能な値： 768p、1080p
​
extra.prompt_optimizer
boolean
デフォルト:"true"
プロンプト最適化を有効にするかどうか
​
extra.fast_pretreatment
boolean
高速前処理モード
​
extra.subject_reference
array
キャラクター参照、キャラクターの一貫性を維持
"extra": {
  "subject_reference": [{
    "type": "character",
    "image": ["https://example.com/character.jpg"]
  }]
}

​
生成モード

モードパラメータ対応モデル
テキストから動画prompt全て
画像から動画prompt + image_urls(1枚)全て
先頭末尾フレームimage_urls(1枚) + last_framehailuo-02
キャラクター参照prompt + extra.subject_referencehailuo-2.3 シリーズ

​
レスポンス

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