> ## 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`で囲んだりしないでください。

## 対応モデル

| モデルID | 解像度 | 標準生成の動画の長さ（秒） |
| - | - | - |
| [kling-3.0](/ja/model-api/kuaishou/kling-3.0) | 720p / 1080p / 4k | 3-15 |
| [kling-3.0-turbo](/ja/model-api/kuaishou/kling-3.0-turbo) | 720p / 1080p | 3-15 |
| [kling-2.6](/ja/model-api/kuaishou/kling-2.6) | 720p / 1080p | 5 / 10 |
| [kling-2.5-turbo](/ja/model-api/kuaishou/kling-2.5-turbo) | 720p / 1080p | 5 / 10 |

## リクエストパラメーター

| フィールド | 型 | 必須 | 説明 |
| - | - | - | - |
| `prompt` | string | はい | 生成したい内容と除外したい内容の記述を含む空でないテキスト。3.0/3.0 Turbo: 最大3072文字、推奨は2500文字以内。2.6/2.5 Turbo: 最大2500文字。 |
| `settings.resolution` | string | いいえ | デフォルトは720pです。上記の対応状況に従い、小文字の720p、1080p、4kを使用してください。 |
| `settings.duration` | integer | いいえ | デフォルトは5です。3.0/3.0 Turboでは3〜15の整数、2.6/2.5 Turboでは5または10のみです。 |
| `settings.aspect_ratio` | string | いいえ | 16:9（デフォルト）、9:16、または1:1。 |
| `settings.audio` | string | いいえ | 3.0/2.6のみ：off（デフォルト）またはnative。2.6のnativeには1080pが必要です。3.0 Turbo（音声内蔵）と2.5 Turbo（未対応）では省略してください。 |
| `settings.multi_shot` | boolean | いいえ | 3.0のみ。デフォルトはtrue。falseでマルチショット生成を無効にします。Turboにはこの切り替えがないため、ストーリーボード形式のプロンプトを使用してください。 |

3.0および3.0 Turboでは、`shot n, m, words;`を使用します。ショット数は1～6、各ショットは1秒以上、長さの合計は全体の長さと一致させ、各ショットのプロンプトは512文字以内にします。このエンドポイントに画像を送信しないでください。

## リクエスト例

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

```bash theme={null}
curl --request POST "https://api.mixroute.ai/kling/text-to-video/kling-3.0" \
  --header "Authorization: Bearer $MIXROUTE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "prompt": "A red ceramic mug slowly rotates on a white tabletop. Static camera, soft studio lighting.",
  "settings": {
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "16:9",
    "audio": "off",
    "multi_shot": false
  },
  "options": {
    "watermark_info": {
      "enabled": false
    }
  }
}'
```

[Klingの概要](/ja/api-reference/endpoint/kling)を参照してください。

## 送信時のレスポンス

```json theme={null}
{
  "code": 0,
  "message": "",
  "request_id": "REQUEST_ID",
  "data": {
    "id": "task_example",
    "status": "submitted"
  }
}
```

`data.id`を保持し、`succeeded`または`failed`になるまで[Klingタスクの照会](/ja/api-reference/endpoint/kling-tasks)を使用してください。送信の成功は、生成の完了を意味しません。


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