> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mixroute.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Klingの概要

> Klingのネイティブエンドポイント、対応モデル、共通オプション、課金、およびタスクのワークフロー。

`Authorization: Bearer $MIXROUTE_API_KEY`を使用してMixRouteのAPIキーで認証し、JSONを送信してください。モデルIDはボディの`model`フィールドではなく、URLに含めます。`/v1`を追加したり、リクエストを`metadata`で囲んだりしないでください。

## 対応モデル

| モデル | 生成エンドポイント | 解像度 |
| - | - | - |
| [Kling 3.0](/ja/model-api/kuaishou/kling-3.0) | [テキストから動画](/ja/api-reference/endpoint/kling-text-to-video) / [画像から動画](/ja/api-reference/endpoint/kling-image-to-video) / [モーション制御](/ja/api-reference/endpoint/kling-motion-control) | 標準生成は最大4k、モーションは最大1080p |
| [Kling 3.0 Turbo](/ja/model-api/kuaishou/kling-3.0-turbo) | [テキストから動画を生成](/ja/api-reference/endpoint/kling-text-to-video) / [画像から動画を生成](/ja/api-reference/endpoint/kling-image-to-video) | 720p / 1080p |
| [Kling 3.0 Omni](/ja/model-api/kuaishou/kling-3.0-omni) | [Omni生成と編集](/ja/api-reference/endpoint/kling-omni-video) | 720p / 1080p / 4k |
| [Kling O1](/ja/model-api/kuaishou/kling-o1) | [Omni生成と編集](/ja/api-reference/endpoint/kling-omni-video) | 720p / 1080p |
| [Kling 2.6](/ja/model-api/kuaishou/kling-2.6) | [テキストから動画](/ja/api-reference/endpoint/kling-text-to-video) / [画像から動画](/ja/api-reference/endpoint/kling-image-to-video) / [モーション制御](/ja/api-reference/endpoint/kling-motion-control) | 720p / 1080p |
| [Kling 2.5 Turbo](/ja/model-api/kuaishou/kling-2.5-turbo) | [テキストから動画を生成](/ja/api-reference/endpoint/kling-text-to-video) / [画像から動画を生成](/ja/api-reference/endpoint/kling-image-to-video) | 720p / 1080p |

ご自身のアカウントで利用可能な完全な識別子を使用してください。エンドポイントとモデルは一致している必要があります。`kling-3.0-omni`と`kling-o1`は、標準のテキスト/画像エンドポイントではなく`omni-video`を使用します。モーション制御には、専用のモーションモデルではなく`kling-3.0`または`kling-2.6`を使用します。

## ワークフロー

1. エンドポイントを選択し、そのネイティブ形式のボディを送信します。
2. HTTPステータスとJSONの`code`の両方を確認してください。`code=0`はリクエストの成功を意味します。
3. 送信時の`data.id`を保存し、ゲートウェイのタスクIDを1件ずつ照会します。
4. `succeeded`の後、`data[0].outputs`内の`type=video`エントリから`url`を読み取ってください。
5. 結果配信CDNにMixRouteキーを送信してはなりません。送信時のタイムアウトは、タスクが作成されなかった証拠にはなりません。POSTを自動的に再試行しないでください。

## 共通オプション

| フィールド | 型 | 必須 | 説明 |
| - | - | - | - |
| `options` | object | いいえ | 共通の設定オブジェクト。 |
| `options.watermark_info.enabled` | boolean | いいえ | デフォルトはfalseです。透かし付きの結果も取得するにはtrueに設定してください。カスタム透かしはサポートされていません。 |
| `options.external_task_id` | string | いいえ | カスタムの業務用識別子で、上流アカウント内で一意である必要があります。ゲートウェイのタスクIDを置き換えるものでも、冪等性を保証するものでもありません。MixRouteでは、この識別子による照会はできません。 |
| `options.callback_url` | string | いいえ | 上流に転送されるコールバックURLです。そこで使用されるIDは上流のIDであり、送信時に返されるゲートウェイのdata.idではありません。プレフィックスでIDの発行元を判断しないでください。ゲートウェイのタスクはポーリングで追跡してください。 |

## デフォルト値とパラメーターの構造

ゲートウェイは、モーション制御を除き、欠落している`settings.resolution`を`720p`で、欠落している`settings.duration`を`5`で補完します。テキストから動画を生成する場合のデフォルトは`16:9`です。画像から動画を生成する場合、Omni、およびモーション制御では、プロンプトをtypeが`prompt`の`contents`項目に配置します。ルートの`prompt`を使うのはテキストから動画を生成する場合だけです。課金に影響するフィールドは明示的に設定してください。特に、2.6のネイティブ音声では`1080p`を明示的に設定してください。

名前と列挙値では大文字と小文字が区別されます。範囲外の値が通知なく別の仕様に変更されることはありません。各モデルには引き続き固有の制約が適用されます。Element IDと音声IDは、ルーティング先の上流アカウントからアクセス可能である必要があります。個人のKlingアカウント内のアセットは自動的には共有されません。

## 課金

以下の基本料金は、生成された動画1秒あたりの米ドル建ての金額です。最終的な請求額は、現在の[モデルマーケットプレイス](https://console.mixroute.ai/models)の価格、アカウントグループの倍率、およびコンソールの請求明細によって決まります。リソースパッケージやアカウント固有の割引は含まれていません。

| モデル | モード | 720p | 1080p | 4k |
| - | - | - | - | - |
| `kling-3.0` | 無音 | 0.084 | 0.112 | 0.42 |
| `kling-3.0` | ネイティブ音声 | 0.126 | 0.168 | 0.42 |
| `kling-3.0` | モーション制御 | 0.126 | 0.168 | 未対応 |
| `kling-3.0-turbo` | ネイティブ音声 | 0.112 | 0.14 | 未対応 |
| `kling-3.0-omni` | 動画入力なし / 無音 | 0.084 | 0.112 | 0.42 |
| `kling-3.0-omni` | 動画入力なし / ネイティブ音声 | 0.112 | 0.14 | 0.42 |
| `kling-3.0-omni` | 動画入力あり | 0.126 | 0.168 | 0.42 |
| `kling-o1` | 動画入力なし | 0.084 | 0.112 | 未対応 |
| `kling-o1` | 動画入力あり | 0.126 | 0.168 | 未対応 |
| `kling-2.6` | 無音 | 0.042 | 0.07 | 未対応 |
| `kling-2.6` | ネイティブ音声 | 未対応 | 0.14 | 未対応 |
| `kling-2.6` | ネイティブ音声 + ボイス | 未対応 | 0.168 | 未対応 |
| `kling-2.6` | モーション制御 | 0.07 | 0.112 | 未対応 |
| `kling-2.5-turbo` | 無音 | 0.042 | 0.07 | 未対応 |

送信時にクォータを予約し、完了時に、リクエストで指定した整数の長さだけでなく、`outputs[].duration`にある小数部分を含む実際の秒数に基づいて精算します。モーション制御では15秒分を予約し、実際の出力時間に応じて増減調整します。失敗またはタイムアウトしたタスクでは、予約済みクォータを解放します。任意のネイティブ`billing`は上流側の情報であり、最終的なMixRouteの請求額を示す証拠ではありません。非対応のティアは無料ティアではありません。

タスクの状態、エラー、ポーリングの完全な例については、[Klingタスクの照会](/ja/api-reference/endpoint/kling-tasks)を参照してください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.