Skip to main content
Klingモーション制御
Authorization: Bearer $MIXROUTE_API_KEYを使用してMixRouteのAPIキーで認証し、JSONを送信してください。モデルIDはボディのmodelフィールドではなく、URLに含めます。/v1を追加したり、リクエストをmetadataで囲んだりしないでください。 kling-3.0とkling-2.6に対応し、どちらも720p / 1080pのみ利用可能で、4kには対応していません。これは参照動画に基づいてキャラクターの動きを制御する機能であり、独立したモーションモデルでも、カメラの動きだけを設定するものでもありません。

リクエストパラメーター

settings.durationを送信しないでください。利用可能な連続した動きによって出力の長さが決まるため、参照動画より短くなる場合があります。少なくとも3秒間の利用可能な動きが必要です。課金は実際に生成された長さに基づきます。

メディアの制限

  • 画像: JPG/JPEG/PNG、最大50 MB。縦横ともに300 px以上、アスペクト比は1:2.5~2.5:1。
  • 動画: MP4/MOV、最大100 MB、各辺340~3850 px。長さはcharacter_orientationによって異なります。
  • 画像と動画で人物の体の比率を合わせてください。頭部と四肢が隠れずにはっきり見えるようにします。1人の人物が映る連続した単一ショットが適しています。カットの切り替えや速い動きは避けてください。

リクエスト例

環境変数MIXROUTE_API_KEYを設定してください。example.comのメディアURLは、実際の公開アクセス可能なファイルに置き換えてください。
Klingの概要を参照してください。

送信時のレスポンス

data.idを保持し、succeededまたはfailedになるまでKlingタスクの照会を使用してください。送信の成功は、生成の完了を意味しません。