メインコンテンツへスキップ
POST
/
v1
/
tasks
curl -X POST https://qingbo.dev/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v2-master",
    "action": "generate",
    "prompt": "一条锦鲤在清澈的池塘中游动，水面波光粼粼",
    "aspect_ratio": "16:9",
    "duration": 5,
    "extra": {
      "mode": "pro"
    }
  }'

{
  "task_id": "task-wave1775285160b950328499",
  "model": "kling-v2-master",
  "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": "kling-v2-master",
    "action": "generate",
    "prompt": "一条锦鲤在清澈的池塘中游动，水面波光粼粼",
    "aspect_ratio": "16:9",
    "duration": 5,
    "extra": {
      "mode": "pro"
    }
  }'

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

​
利用可能なモデル

モデル ID説明
kling-v3Kling V3、3-15秒・マルチショット・ネイティブ音声に対応
kling-v2-masterKling V2 Master
kling-v1-6Kling V1.6、カメラ制御に対応
kling-v1Kling V1

​
統一パラメータ

​
model
string
必須
モデル ID
​
action
string
デフォルト:"generate"
操作タイプ
​
prompt
string
必須
動画の説明テキスト、最大2500文字
​
aspect_ratio
string
デフォルト:"16:9"
アスペクト比：16:9、9:16、1:1画像から動画生成時はこのパラメータは無視され、アスペクト比は入力画像に従います
​
duration
integer
デフォルト:"5"
動画の長さ（秒）：5、10
​
negative_prompt
string
表示させたくない内容、最大2500文字。V1 / V1.6 のみ対応
​
image_urls
string[]
参照画像 URL（先頭フレーム）、画像から動画生成に使用。JPEG/PNG/WebP、≤ 10MB
​
last_frame
string
末尾フレーム画像 URL、image_urls と併用が必要
​
callback_url
string
Webhook コールバックアドレス
​
extra
object
Kling にパススルーされる追加パラメータ、各モデルの Tab を参照

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

duration の範囲： 3-15秒
​
extra.mode
string
デフォルト:"std"
生成モード：std（720P）または pro（1080P）
​
extra.enable_audio
boolean
デフォルト:"true"
ネイティブ音声生成、デフォルトで有効
マルチショットモード：2-6ショットの分割生成に対応。prompt + duration の代わりに shot_N_prompt + shot_N_duration を使用します：
"extra": {
  "shot_1_prompt": "特写：一杯咖啡在桌上冒着热气",
  "shot_1_duration": 5,
  "shot_2_prompt": "镜头拉远，展示整个咖啡馆的场景",
  "shot_2_duration": 5
}
各ショットの duration の合計は3-15秒の範囲内である必要があります。

​
生成モード

モードパラメータ説明
テキストから動画promptテキストのみで生成
画像から動画prompt + image_urls(1枚)先頭フレーム画像 + テキスト説明
先頭末尾フレームimage_urls(1枚) + last_frame開始・終了画面の遷移
画像から動画生成時、aspect_ratio は入力画像に従うため、指定不要です。

​
レスポンス

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