メインコンテンツへスキップ
POST
/
v3
/
async
/
kling-v3.0-pro-i2v
Kling v3.0 Pro 画像から動画
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/kling-v3.0-pro-i2v \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "image": "<string>",
  "sound": true,
  "prompt": "<string>",
  "duration": 123,
  "cfg_scale": 123,
  "end_image": "<string>",
  "multi_prompt": [
    {}
  ],
  "negative_prompt": "<string>"
}
'
{
  "task_id": "<string>"
}
Kling v3.0 Pro 画像から動画ツールは、静止画像を動的な動画に変換し、主体の一貫性を維持しながら、自然な動きとより滑らかなシーンのダイナミクスを生成します。3〜15 秒の柔軟な長さ、音声と動画の同期生成、終端フレーム制御、マルチショット動画生成に対応しています。
これは非同期API であり、非同期タスクの task_id のみを返します。この task_id を使用して タスク結果照会 API にリクエストし、生成結果を取得してください。

​
リクエストヘッダー

​
Content-Type
string
必須
列挙値: application/json
​
Authorization
string
必須
Bearer 認証形式: Bearer {{API Key}}。

​
リクエストボディ

​
image
string
必須
動画の最初のフレーム画像。.jpg、.jpeg、.png に対応しています。画像ファイルサイズは 10MB を超えてはいけません。幅と高さはいずれも >= 300px である必要があります。アスペクト比は 1:2.5 から 2.5:1 の間である必要があります。
​
sound
boolean
デフォルト:false
動画生成時に音声も同時に生成するかどうか。
​
prompt
string
必須
動画生成のポジティブプロンプトテキスト。シーンの動き、カメラ移動、アクション、音声スタイル、雰囲気、効果音を記述できます。2500 文字を超えてはいけません。
​
duration
integer
デフォルト:5
生成する動画の長さ（秒）。3〜15 秒の柔軟な長さに対応しています。値の範囲：[3, 15]
​
cfg_scale
number
動画生成の柔軟性を制御します。値が高いほど、モデルが生成する内容はプロンプトにより忠実になります。値が低いほど、動きの効果はより自然になります。値の範囲：[0, 1]
​
end_image
string
遷移効果をガイドするための終端フレーム画像 URL。multi_prompt とは互換性がありません。.jpg、.jpeg、.png に対応しています。
​
multi_prompt
array
マルチショット動画生成用のプロンプトリスト。動画を複数のショットに分割します。prompt とは相互排他的です。
​
negative_prompt
string
ネガティブプロンプト。映像と音声で避けるべき要素を指定します。長さは 2500 文字を超えてはいけません。

​
レスポンス情報

​
task_id
string
必須
task_id を使用して タスク結果照会 API にリクエストし、生成された出力を取得します。