動作コントロール
POST
/kling/v1/videos/motion-control
参照画像と参照動画に基づいて、動作コントロール動画タスクを作成します。
Authorizations
bearer
Type
HTTP (bearer)
Request Body
application/json
model_name
string
デフォルト:kling-v2-6、kling-v3
prompt
string
テキストプロンプト(正/負の説明を含められます)。
プロンプトで画面要素の追加やカメラワークの指定などが可能です。詳細は Kling「モーションコントロール」ガイド:
https://docs.qingque.cn/d/home/eZQAl5y8xNSkr0iYUS8-bpGvP?identityId=2Cn18n4EIHT#section=h.xtmfpd68o18
2500 文字以内。
image_url
string
Required
参照画像(Base64 またはアクセス可能な画像 URL)。人物・背景などの要素を参照画像に合わせます。
対応形式:.jpg / .jpeg / .png、最大 10MB。
最小 300px、アスペクト比 1:2.5 ~ 2.5:1。
video_url
string
Required
参照動画(アクセス可能な URL)。
対応形式:.mp4 / .mov、最大 100MB。
縦横の辺長は 340px~3850px の範囲。
長さは 3 秒以上。最大長は character_orientation に依存します。
keep_original_sound
string
参照動画の原音を保持するかどうか。
列挙値:yes、no。
character_orientation
string
Required
生成動画の人物の向きの参照元。
列挙値:image、video。
- image:画像に合わせる(参照動画は 10 秒以内)
- video:動画に合わせる(参照動画は 30 秒以内)
mode
string
Required
動画生成モード。
列挙値:std、pro。
- std:標準モード(コスパ重視)
- pro:プロモード(高品質)
element_list
object[]
主体参照リスト
Expand
watermark_info
object[]
透かし付き結果も同時に生成するかどうか
Expand
callback_url
string
external_task_id
string
Responses
OK
application/json
object