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

# kling-3.0-turbo

> 通过可灵新版文生视频和图生视频 API 调用 Kling 3.0 Turbo。

Kling 3.0 Turbo 是快手推出的视频生成模型，支持文生视频和首帧图生视频。AnyFast 按照可灵新版“模型即接口”结构提供该模型。

<Info>
  Kling 3.0 Turbo 仅使用新版 API。模型由请求路径确定，请求体不需要传入 `model_name`，也不使用旧版 `/kling/v1/videos/...` 请求结构。
</Info>

## 支持的能力

| 能力   | 请求路径                                            | 主要输入                  |
| ---- | ----------------------------------------------- | --------------------- |
| 文生视频 | `POST /kling/v2/text-to-video/kling-3.0-turbo`  | `prompt`              |
| 图生视频 | `POST /kling/v2/image-to-video/kling-3.0-turbo` | 包含提示词与首帧图的 `contents` |

两种能力均支持 720p 和 1080p，视频时长支持 3 至 15 秒。文生视频还支持 `16:9`、`9:16` 和 `1:1` 画面比例。

## 文生视频

```bash cURL theme={null}
curl --request POST \
  --url https://www.anyfast.ai/kling/v2/text-to-video/kling-3.0-turbo \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "prompt": "一位女孩坐在火车上望向窗外，车厢轻轻摇晃",
    "settings": {
      "resolution": "1080p",
      "aspect_ratio": "16:9",
      "duration": 5
    },
    "options": {
      "watermark_info": {
        "enabled": false
      }
    }
  }'
```

提示词可以同时包含正向和负向描述，最长 3072 个字符，建议控制在 2500 个字符以内。

### 多镜头提示词

Kling 3.0 Turbo 可以通过固定格式生成 1 至 6 个镜头：

```text theme={null}
镜头 1, 2, 火车驶过桥梁的广角画面;
镜头 2, 3, 镜头进入车厢并靠近窗边的乘客;
```

每个镜头至少持续 1 秒，全部镜头时长之和必须等于请求的视频总时长，每个镜头的提示词最长 512 个字符。

## 图生视频

```bash cURL theme={null}
curl --request POST \
  --url https://www.anyfast.ai/kling/v2/image-to-video/kling-3.0-turbo \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "contents": [
      {
        "type": "prompt",
        "text": "人物转头望向窗外，背景自然移动"
      },
      {
        "type": "first_frame",
        "url": "https://example.com/first-frame.png"
      }
    ],
    "settings": {
      "resolution": "1080p",
      "duration": 5
    },
    "options": {
      "watermark_info": {
        "enabled": false
      }
    }
  }'
```

`contents` 数组可以传入一个 `prompt` 和一个 `first_frame`。Kling 3.0 Turbo 当前仅支持首帧图，不支持尾帧图或首尾帧组合输入。

<Warning>
  输入图片支持 JPG、JPEG 和 PNG，文件不能超过 50 MB。图片宽高均不能小于 300 px，宽高比须在 1:2.5 至 2.5:1 之间。首帧图可以使用公开 URL 或 Base64 内容。
</Warning>

## 异步任务流程

创建接口返回异步任务，任务状态包括 `submitted`、`processing`、`succeeded` 和 `failed`。通过以下接口查询一个或多个任务 ID：

```http theme={null}
GET /kling/v2/tasks?task_ids=TASK_ID
```

任务成功后，生成的视频位于 `data[].outputs[]`。结果链接会在 30 天后清理，请及时下载并保存。

<Card title="Kling 3.0 Turbo API 参考" icon="code" href="/zh/api-reference/model-api/kuaishou/kling-v3-turbo">
  查看完整请求字段和新版任务响应结构。
</Card>

<script src="/feedback.js" />