全部文档
当前文档
最近更新时间：2025-11-28 13:24:32
字段 | 类型 | 必填 | 默认值 | 描述 |
model_name | string | 必填 | 无 | 模型名称 枚举值：kling-v2-1-master, kling-v2-5-turbo |
prompt | string | 必填 | 无 | 正向文本提示词
|
negative_prompt | string | 可选 | 无 | 负向文本提示词
|
mode | string | 可选 | std | 生成视频的模式
|
camera_control | object | 可选 | 空 | 控制摄像机运动的协议（如未指定，模型将根据输入的文本/图片进行智能匹配） |
camera_control
| string | 可选 | 无 | 预定义的运镜类型
|
camera_control
| object | 可选 | 无 | 包含六个字段，用于指定摄像机在不同方向上的运动或变化
|
camera_control
| float | 可选 | 无 | 水平运镜，控制摄像机在水平方向上的移动量（沿x轴平移） 取值范围：[-10, 10]，负值表示向左平移，正值表示向右平移 |
camera_control
| float | 可选 | 无 | 垂直运镜，控制摄像机在垂直方向上的移动量（沿y轴平移） 取值范围：[-10, 10]，负值表示向下平移，正值表示向上平移 |
camera_control
| float | 可选 | 无 | 水平摇镜，控制摄像机在水平面上的旋转量（绕y轴旋转） 取值范围：[-10, 10]，负值表示绕y轴向左旋转，正值表示绕y轴向右旋转 |
camera_control
| float | 可选 | 无 | 垂直摇镜，控制摄像机在垂直面上的旋转量（沿x轴旋转） 取值范围：[-10, 10]，负值表示绕x轴向下旋转，正值表示绕x轴向上旋转 |
camera_control
| float | 可选 | 无 | 旋转运镜，控制摄像机的滚动量（绕z轴旋转） 取值范围：[-10, 10]，负值表示绕z轴逆时针旋转，正值表示绕z轴顺时针旋转 |
camera_control
| float | 可选 | 无 | 变焦，控制摄像机的焦距变化，影响视野的远近 取值范围：[-10, 10]，负值表示焦距变长、视野范围变小，正值表示焦距变短、视野范围变大 |
aspect_ratio | string | 可选 | 16:9 | 生成视频的画面纵横比（宽:高） 枚举值：16:9, 9:16, 1:1 |
duration | string | 可选 | 5 | 生成视频时长，单位s 枚举值：5，10 |
external_task_id | string | 可选 | 无 | 自定义任务ID
|
curl --location 'https://kspmas.ksyun.com/v1/videos/text2video' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer $KSC_API_KEY' \
-d '{
"model_name": "kling-v2-5-turbo",
"prompt":"宇航员躺下睡着了",
"negative_prompt":"不要畸形，不要多余的手指，不要模糊，不要过暗，不要扭曲",
"mode":"pro"
"duration":5
}'{
"code": 0, //错误码；具体定义见错误码
"message": "string", //错误信息
"request_id": "string", //请求ID，系统生成，用于跟踪请求、排查问题
"data": {
"task_id": "string", //任务ID，系统生成
"task_info": {
//任务创建时的参数信息
"external_task_id": "string" //客户自定义任务ID
},
"task_status": "string", //任务状态，枚举值：submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败）
"created_at": 1722769557708, //任务创建时间，Unix时间戳、单位ms
"updated_at": 1722769557708 //任务更新时间，Unix时间戳、单位ms
}
}
首尾帧视频生成仅kling-2-5-turbo的pro模式支持
字段 | 类型 | 必填 | 默认值 | 描述 |
model_name | string | 可选 | kling-v1 | 模型名称
|
image | string | 必须 | 空 | 参考图像
请注意，若您使用base64的方式，请确保您传递的所有图像数据参数均采用Base64编码格式。在提交数据时，请不要在Base64编码字符串前添加任何前缀，例如data:image/png;base64,。正确的参数格式应该直接是Base64编码后的字符串。 示例： 正确的Base64编码参数： 错误的Base64编码参数（包含data:前缀）： 请仅提供Base64编码的字符串部分，以便系统能够正确处理和解析您的数据。
|
image_tail | string | 可选 | 空 | 参考图像 - 尾帧控制
请注意，若您使用base64的方式，请确保您传递的所有图像数据参数均采用Base64编码格式。在提交数据时，请不要在Base64编码字符串前添加任何前缀，例如data:image/png;base64,。正确的参数格式应该直接是Base64编码后的字符串。 示例： 正确的Base64编码参数： 错误的Base64编码参数（包含data:前缀）： 请仅提供Base64编码的字符串部分，以便系统能够正确处理和解析您的数据。
|
prompt | string | 可选 | 无 | 正向文本提示词
|
negative_prompt | string | 可选 | 空 | 负向文本提示词
|
mode | string | 可选 | std | 生成视频的模式
|
static_mask | string | 可选 | 无 | 静态笔刷涂抹区域（用户通过运动笔刷涂抹的 mask 图片） “运动笔刷”能力包含“动态笔刷 dynamic_masks”和“静态笔刷 static_mask”两种
|
dynamic_masks | array | 可选 | 无 | 动态笔刷配置列表 可配置多组（最多6组），每组包含“涂抹区域 mask”与“运动轨迹 trajectories”序列不同模型版本、视频模式支持范围不同，详见当前文档3-0能力地图 |
dynamic_masks
| string | 可选 | 无 | 动态笔刷涂抹区域（用户通过运动笔刷涂抹的 mask 图片）
|
dynamic_masks
| array | 可选 | 无 | 运动轨迹坐标序列
注1：坐标点个数越多轨迹刻画越准确，如只有2个轨迹点则为这两点连接的直线 注2：轨迹方向以传入顺序为指向，以最先传入的坐标为轨迹起点，依次链接后续坐标形成运动轨迹 |
dynamic_masks
| int | 可选 | 无 | 轨迹点横坐标（在像素二维坐标系下，以输入图片image左下为原点的像素坐标） |
dynamic_masks
| int | 可选 | 无 | 轨迹点纵坐标（在像素二维坐标系下，以输入图片image左下为原点的像素坐标） |
camera_control | object | 可选 | 空 | 控制摄像机运动的协议（如未指定，模型将根据输入的文本/图片进行智能匹配） 不同模型版本、视频模式支持范围不同，详见当前文档3-0能力地图 |
camera_control
| string | 可选 | 无 | 预定义的运镜类型
|
camera_control
| object | 可选 | 无 | 包含六个字段，用于指定摄像机在不同方向上的运动或变化
|
config
| float | 可选 | 无 | 水平运镜，控制摄像机在水平方向上的移动量（沿x轴平移）
|
config
| float | 可选 | 无 | 垂直运镜，控制摄像机在垂直方向上的移动量（沿y轴平移）
|
config
| float | 可选 | 无 | 水平摇镜，控制摄像机在水平面上的旋转量（绕y轴旋转）
|
config
| float | 可选 | 无 | 垂直摇镜，控制摄像机在垂直面上的旋转量（沿x轴旋转）
|
config
| float | 可选 | 无 | 旋转运镜，控制摄像机的滚动量（绕z轴旋转）
|
config
| float | 可选 | 无 | 变焦，控制摄像机的焦距变化，影响视野的远近
|
duration | string | 可选 | 5 | 生成视频时长，单位s
|
external_task_id | string | 可选 | 无 | 自定义任务ID
|
curl --location 'https://kspmas.ksyun.com/v1/videos/image2video' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer $KSC_API_KEY' \
-d '{
"model_name": "kling-v2-5-turbo",
"mode": "pro",
"duration": "5",
"image": "https://h2.inkwai.com/bs2/upload-ylab-stunt/se/ai_portal_queue_mmu_image_upscale_aiweb/3214b798-e1b4-4b00-b7af-72b5b0417420_raw_image_0.jpg",
"prompt": "宇航员躺下睡着了",
"static_mask": "https://h2.inkwai.com/bs2/upload-ylab-stunt/ai_portal/1732888177/cOLNrShrSO/static_mask.png",
"dynamic_masks": [
{
"mask": "https://h2.inkwai.com/bs2/upload-ylab-stunt/ai_portal/1732888130/WU8spl23dA/dynamic_mask_1.png",
"trajectories": [
{"x":279,"y":219},{"x":417,"y":65}
]
}
]
}'
{
"code": 0, //错误码；具体定义见错误码
"message": "string", //错误信息
"request_id": "string", //请求ID，系统生成，用于跟踪请求、排查问题
"data": {
"task_id": "string", //任务ID，系统生成
"task_info": {
//任务创建时的参数信息
"external_task_id": "string" //客户自定义任务ID
},
"task_status": "string", //任务状态，枚举值：submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败）
"created_at": 1722769557708, //任务创建时间，Unix时间戳、单位ms
"updated_at": 1722769557708 //任务更新时间，Unix时间戳、单位ms
}
}
字段 | 类型 | 必填 | 默认值 | 描述 |
task_id | string | 可选 | 无 | 图生视频的任务ID 请求路径参数，直接将值填写在请求路径中，与external_task_id两种查询方式二选一 |
external_task_id | string | 可选 | 无 | 图生视频的自定义任务ID 创建任务时填写的external_task_id，与task_id两种查询方式二选一 |
curl --location 'http://kspmas.ksyun.com/v1/videos/text2video/{task_id}' \
--header 'Authorization: Bearer $KSC_API_KEY' \{
"code": 0, //错误码；具体定义见错误码
"message": "string", //错误信息
"request_id": "string", //请求ID，系统生成，用于跟踪请求、排查问题
"data":{
"task_id": "string", //任务ID，系统生成
"task_status": "string", //任务状态，枚举值：submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败）
"task_status_msg": "string", //任务状态信息，当任务失败时展示失败原因（如触发平台的内容风控等）
"task_info": { //任务创建时的参数信息
"external_task_id": "string"//客户自定义任务ID
},
"task_result":{
"videos":[
{
"id": "string", //生成的视频ID；全局唯一
"url": "string", //生成视频的URL，例如https://p1.a.kwimgs.com/bs2/upload-ylab-stunt/special-effect/output/HB1_PROD_ai_web_46554461/-2878350957757294165/output.mp4（请注意，为保障信息安全，生成的图片/视频会在30天后被清理，请及时转存）
"duration": "string" //视频总时长，单位s
}
]
}
"created_at": 1722769557708, //任务创建时间，Unix时间戳、单位ms
"updated_at": 1722769557708, //任务更新时间，Unix时间戳、单位ms
}
}
纯净模式