> ## 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 文生影片的提示詞、音訊、畫幅和時長引數。

使用 MixRoute API Key，以 `Authorization: Bearer $MIXROUTE_API_KEY` 認證，請求體為 JSON。模型 ID 位於 URL 中，不在請求體中重複傳 `model`；不新增 `/v1`，也不使用 `metadata` 包裝。

## 支援模型

| 模型 ID                                                          | 解析度               | 普通生成時長（秒） |
| -------------------------------------------------------------- | ----------------- | --------- |
| [kling-3.0](/zh-hant/model-api/kuaishou/kling-3.0)             | 720p / 1080p / 4k | 3-15      |
| [kling-3.0-turbo](/zh-hant/model-api/kuaishou/kling-3.0-turbo) | 720p / 1080p      | 3-15      |
| [kling-2.6](/zh-hant/model-api/kuaishou/kling-2.6)             | 720p / 1080p      | 5 / 10    |
| [kling-2.5-turbo](/zh-hant/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` 媒體地址替換為無需登入即可訪問的真實素材。

```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 概覽](/zh-hant/api-reference/endpoint/kling)。

## 提交響應

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

儲存 `data.id`，使用 [查詢 Kling 任務](/zh-hant/api-reference/endpoint/kling-tasks) 輪詢至 `succeeded` 或 `failed`。提交成功不代表生成完成。