## 创建任务
`POST /kling/v2/text-to-video/kling-3.0-turbo`
```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
}
}
}'
```
```json 200 theme={null}
{
"code": 0,
"message": "string",
"request_id": "string",
"data": {
"id": "893605946402811985",
"status": "submitted",
"create_time": 1781080778802,
"update_time": 1781080794151,
"external_id": ""
}
}
```
## 请求头
Bearer 鉴权，格式为 `Bearer YOUR_API_KEY`。
数据交换格式。
## 请求体
文本提示词，可以包含正向和负向描述。最长 3072 个字符，建议控制在 2500 个字符以内。
输出清晰度、画面比例和时长配置。
视频清晰度。枚举值：`720p`、`1080p`。
画面比例。枚举值：`16:9`、`9:16`、`1:1`。
视频时长，单位为秒。支持 3 至 15 的整数。
通用生成配置。
平台水印配置。
设为 `true` 时同时生成含水印结果。
### 多镜头提示词格式
提示词可以使用 `镜头 n, m, words;` 格式定义 1 至 6 个镜头。`n` 为镜头序号，`m` 为镜头时长，`words` 为镜头描述。每个镜头至少持续 1 秒，全部镜头时长之和必须等于 `settings.duration`，每个镜头描述最长 512 个字符。
## 创建响应
错误码，`0` 表示请求已受理。
错误或状态信息。
系统生成的请求 ID，用于链路跟踪和问题排查。
创建的异步任务。
系统生成的任务 ID。
任务状态：`submitted`、`processing`、`succeeded` 或 `failed`。
任务创建时间，Unix 毫秒时间戳。
任务更新时间，Unix 毫秒时间戳。
存在时返回自定义任务 ID。
## 创建任务
`POST /kling/v2/image-to-video/kling-3.0-turbo`
```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
}
}
}'
```
```json 200 theme={null}
{
"code": 0,
"message": "string",
"request_id": "string",
"data": {
"id": "893605946402811985",
"status": "submitted",
"create_time": 1781080778802,
"update_time": 1781080794151,
"external_id": ""
}
}
```
## 请求头
Bearer 鉴权，格式为 `Bearer YOUR_API_KEY`。
数据交换格式。
## 请求体
参考素材集合。在同一数组中传入提示词和首帧图。
素材类型。枚举值：`prompt`、`first_frame`。
`type` 为 `prompt` 时必填。可以包含正向和负向描述，最长 2500 个字符。
`type` 为 `first_frame` 时必填。支持公开 URL 或 Base64 图片内容。
输出清晰度和时长配置。
视频清晰度。枚举值：`720p`、`1080p`。
视频时长，单位为秒。支持 3 至 15 的整数。
通用生成配置。
平台水印配置。
设为 `true` 时同时生成含水印结果。
### 首帧图要求
输入图片支持 JPG、JPEG 和 PNG，文件不能超过 50 MB。图片宽高均不能小于 300 px，宽高比须在 1:2.5 至 2.5:1 之间。Kling 3.0 Turbo 仅支持首帧图，不支持尾帧图或首尾帧组合输入。
### 多镜头提示词格式
`prompt` 素材可以使用 `镜头 n, m, words;` 格式定义 1 至 6 个镜头。每个镜头至少持续 1 秒，全部时长之和必须等于 `settings.duration`，每个镜头描述最长 512 个字符。
## 创建响应
错误码，`0` 表示请求已受理。
错误或状态信息。
系统生成的请求 ID。
系统生成的任务 ID。
任务状态：`submitted`、`processing`、`succeeded` 或 `failed`。
任务创建时间，Unix 毫秒时间戳。
任务更新时间，Unix 毫秒时间戳。
存在时返回自定义任务 ID。