Authorization: Bearer $MIXROUTE_API_KEYを使用してMixRouteのAPIキーで認証し、JSONを送信してください。モデルIDはボディのmodelフィールドではなく、URLに含めます。/v1を追加したり、リクエストをmetadataで囲んだりしないでください。
対応モデル
ご自身のアカウントで利用可能な完全な識別子を使用してください。エンドポイントとモデルは一致している必要があります。
kling-3.0-omniとkling-o1は、標準のテキスト/画像エンドポイントではなくomni-videoを使用します。モーション制御には、専用のモーションモデルではなくkling-3.0またはkling-2.6を使用します。
ワークフロー
- エンドポイントを選択し、そのネイティブ形式のボディを送信します。
- HTTPステータスとJSONの
codeの両方を確認してください。code=0はリクエストの成功を意味します。 - 送信時の
data.idを保存し、ゲートウェイのタスクIDを1件ずつ照会します。 succeededの後、data[0].outputs内のtype=videoエントリからurlを読み取ってください。- 結果配信CDNにMixRouteキーを送信してはなりません。送信時のタイムアウトは、タスクが作成されなかった証拠にはなりません。POSTを自動的に再試行しないでください。
共通オプション
デフォルト値とパラメーターの構造
ゲートウェイは、モーション制御を除き、欠落しているsettings.resolutionを720pで、欠落しているsettings.durationを5で補完します。テキストから動画を生成する場合のデフォルトは16:9です。画像から動画を生成する場合、Omni、およびモーション制御では、プロンプトをtypeがpromptのcontents項目に配置します。ルートのpromptを使うのはテキストから動画を生成する場合だけです。課金に影響するフィールドは明示的に設定してください。特に、2.6のネイティブ音声では1080pを明示的に設定してください。
名前と列挙値では大文字と小文字が区別されます。範囲外の値が通知なく別の仕様に変更されることはありません。各モデルには引き続き固有の制約が適用されます。Element IDと音声IDは、ルーティング先の上流アカウントからアクセス可能である必要があります。個人のKlingアカウント内のアセットは自動的には共有されません。
課金
以下の基本料金は、生成された動画1秒あたりの米ドル建ての金額です。最終的な請求額は、現在のモデルマーケットプレイスの価格、アカウントグループの倍率、およびコンソールの請求明細によって決まります。リソースパッケージやアカウント固有の割引は含まれていません。
送信時にクォータを予約し、完了時に、リクエストで指定した整数の長さだけでなく、
outputs[].durationにある小数部分を含む実際の秒数に基づいて精算します。モーション制御では15秒分を予約し、実際の出力時間に応じて増減調整します。失敗またはタイムアウトしたタスクでは、予約済みクォータを解放します。任意のネイティブbillingは上流側の情報であり、最終的なMixRouteの請求額を示す証拠ではありません。非対応のティアは無料ティアではありません。
タスクの状態、エラー、ポーリングの完全な例については、Klingタスクの照会を参照してください。