01-文生视频
文生视频
文档版本：v1.0.0 | 最后更新：2026-09-02 本平台已完整适配可灵 AI 官方新版视频生成 API，请求与响应均为透传，参数语义与官方一致。
创建任务
POST https://platform.shuyanai.com/kling/text-to-video/{model}{model} 为路径参数，指定使用的模型版本：| 模型 | 说明 |
|---|---|
kling-3.0 | 旗舰模型，支持多镜头、原生音频、最高 4K |
kling-3.0-turbo | 3.0 加速版 |
kling-2.6 | 支持原生音频 |
kling-2.5-turbo | 快速生成，性价比高 |
请求头
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
Content-Type | string | 是 | application/json | 数据交换格式 |
Authorization | string | 是 | 鉴权信息，参考接口鉴权 |
请求体
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
prompt | string | 是 | 文本提示词，可包含正向描述和负向描述 - kling-3.0 / kling-3.0-turbo：不能超过 3072 个字符，建议不超过 2500 个字符- kling-2.6 / kling-2.5-turbo：不能超过 2500 个字符- kling-3.0 / kling-3.0-turbo 支持通过固定格式生成多镜头视频：镜头 n, m, words; 镜头 n, m, words;（半角符号分隔）a. n：分镜序号，最多 6 个分镜，最少 1 个分镜 b. m：分镜时长，每个分镜时长不小于 1，所有分镜时长之和等于视频总时长 c. words：分镜提示词，最大长度 512 | |
settings | object | 否 | 输出配置相关参数，如清晰度、时长等，见下表 | |
options | object | 否 | 通用配置，如回调地址、是否含水印等，见下表 |
settings 子字段| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
resolution | string | 否 | 720p | 生成视频的清晰度 可选值： 720p、1080p、4k- 4k 仅 kling-3.0 支持- kling-2.6 生成有声视频时仅支持 1080p |
aspect_ratio | string | 否 | 16:9 | 生成视频的画面纵横比（宽:高） 可选值： 16:9、9:16、1:1 |
duration | int | 否 | 5 | 生成视频时长，单位：秒 - kling-3.0 / kling-3.0-turbo：可选值 3 ~ 15（整数）- kling-2.6 / kling-2.5-turbo：可选值 5、10 |
audio | string | 否 | off | 是否生成带有声音的视频 可选值： native、off- native：生成的视频含有与画面适配的声音- off：生成的视频不含有声音- 仅 kling-3.0、kling-2.6 支持；kling-2.6 有声时仅支持 1080P |
multi_shot | boolean | 否 | true | 是否生成多镜头视频 - 仅 kling-3.0 支持该参数- 当参数值为 false 时，即便使用多镜头格式的 prompt 也不会生成多镜头视频 |
options 子字段| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
callback_url | string | 否 | 本次任务结果回调通知地址，如果配置，服务端会在任务状态发生变更时主动通知 | |
external_task_id | string | 否 | 自定义任务 ID，传入不会覆盖系统生成的任务 ID，但支持通过该 ID 进行任务查询 请注意，单用户下需要保证唯一性 | |
watermark_info | object | 否 | 是否同时生成含水印的结果，格式：{"enabled": boolean}true 为生成，false 为不生成，默认 false；暂不支持自定义水印 |
各模型参数支持范围
| 参数 | kling-3.0 | kling-3.0-turbo | kling-2.6 | kling-2.5-turbo |
|---|---|---|---|---|
resolution | 720p / 1080p / 4k | 720p / 1080p | 720p / 1080p（有声仅 1080p） | 720p / 1080p |
duration | 3 ~ 15 | 3 ~ 15 | 5 / 10 | 5 / 10 |
audio | native / off | 不支持 | native / off | 不支持 |
multi_shot | 支持 | 不支持（可用多镜头 prompt 格式） | 不支持 | 不支持 |
请求示例
curl --request POST \
--url https://platform.shuyanai.com/kling/text-to-video/kling-3.0 \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"prompt": "一位女孩坐在火车上，望向窗外，神情忧郁，头随火车轻轻摇晃",
"settings": {
"resolution": "1080p",
"aspect_ratio": "16:9",
"duration": 5,
"audio": "native"
},
"options": {
"external_task_id": "my-task-001"
}
}'kling-2.6 有声视频示例（有声仅支持 1080P）：curl --request POST \
--url https://platform.shuyanai.com/kling/text-to-video/kling-2.6 \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"prompt": "海浪轻拍礁石，海鸥在空中盘旋，浪涛声不绝于耳",
"settings": {
"audio": "native",
"resolution": "1080p",
"aspect_ratio": "9:16",
"duration": 10
}
}'响应示例
{
"code": 0, // 错误码；具体定义见错误码
"message": "string", // 错误信息
"request_id": "string", // 请求ID，系统生成，用于跟踪请求、排查问题
"data": {
"id": "string", // 任务ID，系统生成
"status": "string", // 任务状态，枚举值：submitted（已提交）、processing（处理中）、succeeded（成功）、failed（失败）
"create_time": 1781080778802, // 任务创建时间，Unix时间戳、单位ms
"update_time": 1781080794151, // 任务更新时间，Unix时间戳、单位ms
"external_id": "string" // 该任务的自定义任务ID（如有）
}
}查询任务
GET /kling/tasks，支持按系统任务 ID 或自定义任务 ID 查询、批量查询，详见 查询任务。