跳转至

文档中心

MaaS_KL_3.0_turbo

MaaS_KL_3.0_turbo

文生视频

请求URL

POST

https://genaiapi-m2.cloudsway.net/v1/ai/{endpointPath}/kling/videos/text-to-video/kling-3.0-turbo

请求参数

字段	类型	必填	默认值	描述
prompt	string	必填	无	文本提示词，可包含正向描述和负向描述内容长度不能超过3072个字符，建议内容长度不超过2500个字符可将提示词模板化来满足不同的视频生成需求可灵视频3.0 Turbo模型可通过Prompt等内容实现多种能力可通过固定格式生成多镜头视频，格式为“镜头 n, m, words; 镜头 n, m, words;”，用半角符号分隔；其中： n：分镜序号；最多支持6个分镜，最少支持1个分镜 m：分镜时长；每个分镜时长不小于1，所有分镜时长之和等于当前所生成视频总时长 words：分镜提示词；最大长度512 更多信息详见：可灵视频 3.0 模型使用指南
settings	object	选填	空	输出配置相关参数，如清晰度、时长等
settings.resolution	string	选填	720p	生成视频的清晰度枚举值：720p，1080p。其中： 720p：输出清晰度为720P的视频 1080p：输出清晰度为1080P的视频
settings.aspect_ratio	string	可选	16:9	生成视频的画面纵横比（宽:高）枚举值：16:9, 9:16, 1:1
settings.duration	int	选填	5	生成视频时长，单位s 枚举值：3，4，5，6，7，8，9，10，11，12，13，14，15
options	object	选填	空	通用配置，如回调地址、是否含水印等 `"options": { "callback_url": "https://example.com/cb", // 本次任务结果回调通知地址，如果配置，服务端会在任务状态发生变更时主动通知；具体通知的消息schema见“Callback协议” "external_task_id": "string", // 自定义任务ID，可用于查询，不会覆盖系统生成的任务ID，需在账号范围内保证唯一性 "watermark_info": { "enabled": false // 是否生成含水印结果，true为生成，false为不生成；默认为false } }`
options.callback_url	string	选填	空	本次任务结果回调通知地址，如果配置，服务端会在任务状态发生变更时主动通知具体通知的消息schema见“Callback协议”
options.external_task_id	string	选填	空	自定义任务ID 用户自定义任务ID，传入不会覆盖系统生成的任务ID，但支持通过该ID进行任务查询请注意，单用户下需要保证唯一性
options.watermark_info	object	选填	空	是否同时生成含水印的结果通过enabled参数定义，具体object格式如下： `"watermark_info": { "enabled": boolean // 是否生成含水印结果，true为生成，false为不生成；默认为false }` 暂不支持自定义水印

请求示例

curl -g 'https://genaiapi-m2.cloudsway.net/v1/ai/{endpointPath}/kling/videos/text-to-video/kling-3.0-turbo' \
-H 'Authorization: Bearer {Your AK}' \
-H 'Content-Type: application/json' \
-d '{
  "prompt": "A golden retriever running on a sunny beach, cinematic lighting, slow motion",
  "settings": {
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 5
  },
  "options": {
    "watermark_info": {
      "enabled": false
    }
  }
}'

返回示例

{
    "code": 0,
    "message": "SUCCEED",
    "data": {
        "id": "901930004609634393",
        "status": "submitted",
        "message": "",
        "create_time": 1783065388949,
        "update_time": 1783065388949
    },
    "request_id": "ed6ce13d-7c9b-48cc-ba5c-e4ba5c260a60"
}

图生视频

请求URL

POST https://genaiapi-m2.cloudsway.net/v1/ai/{{endpointPath}}/kling/videos/image-to-video/kling-3.0-turbo

请求参数

字段	类型	必填	默认值	描述
contents	array	必填	无	参考素材合集，如提示词、图片等同一个素材的相关字段请放在同一个目录结构中参考格式如下，参数说明详见下文： `"contents": [ { "type": "prompt", "text": "string" }, { "type": "first_frame", "url": "https://your-cdn.com/start-frame.jpg" } ]`
contents.type	string	必填	无	素材类型，支持：提示词、首帧图枚举值：prompt，first_frame；其中： prompt：提示词素材标识； first_frame：首帧图素材标识；
contents.type=prompt	string	选填	空	文本提示词，可包含正向描述和负向描述通过JSON的格式定义，具体如下： `{ "type": "prompt", // 素材类型，固定参数值：prompt；必填 "text": "string" // 文本提示词，可包含正向描述和负向描述，内容不超过 2500 个字符；必填 }` 可将提示词模板化来满足不同的视频生成需求可灵视频3.0 Turbo模型可通过Prompt等内容实现多种能力可通过固定格式生成多镜头视频，格式为“镜头 n, m, words; 镜头 n, m, words;”，用半角符号分隔；其中： n：分镜序号；最多支持6个分镜，最少支持1个分镜 m：分镜时长；每个分镜时长不小于1，所有分镜时长之和等于当前所生成视频总时长 words：分镜提示词；最大长度512 更多信息详见：可灵视频 3.0 模型使用指南
contents.type=first_frame	object	必填	无	首帧图参考素材通过JSON的格式定义，具体如下： `{ "type": "first_frame", // 首帧素材标识，固定参数值：first_frame；必填 "url": "string", // 素材内容，支持通过url或base64的方式提供；直接将相关信息填入即可；必填。大文件建议用url，base64可能导致接口等待时间很长。 }` 图片格式支持.jpg / .jpeg / .png 图片文件大小不能超过50MB 图片宽高尺寸不小于300px，图片宽高比要在1:2.5 ~ 2.5:1之间支持仅首帧，暂不支持首帧+尾帧和仅尾帧
settings	object	选填	空	输出配置相关参数，如清晰度、时长等
settings.resolution	string	选填	720p	生成视频的清晰度枚举值：720p，1080p。其中： 720p：输出清晰度为720P的视频 1080p：输出清晰度为1080P的视频
settings.duration	int	选填	5	生成视频时长，单位s 枚举值：3，4，5，6，7，8，9，10，11，12，13，14，15
options	object	选填	空	通用配置，如回调地址、是否含水印等 `"options": { "callback_url": "https://example.com/cb", // 本次任务结果回调通知地址，如果配置，服务端会在任务状态发生变更时主动通知；具体通知的消息schema见“Callback协议” "external_task_id": "string", // 自定义任务ID，可用于查询，不会覆盖系统生成的任务ID，需在账号范围内保证唯一性 "watermark_info": { "enabled": false // 是否生成含水印结果，true为生成，false为不生成；默认为false } }`
options.callback_url	string	选填	空	本次任务结果回调通知地址，如果配置，服务端会在任务状态发生变更时主动通知具体通知的消息schema见“Callback协议”
options.external_task_id	string	选填	空	自定义任务ID 用户自定义任务ID，传入不会覆盖系统生成的任务ID，但支持通过该ID进行任务查询请注意，单用户下需要保证唯一性
options.watermark_info	object	选填	空	是否同时生成含水印的结果通过enabled参数定义，具体object格式如下： `"watermark_info": { "enabled": boolean // 是否生成含水印结果，true为生成，false为不生成；默认为false }` 暂不支持自定义水印

请求示例

curl -g 'https://genaiapi-m2.cloudsway.net/v1/ai/{{endpointPath}}/kling/videos/image-to-video/kling-3.0-turbo' \
-H 'Authorization: Bearer {Your AK}' \
-H 'Content-Type: application/json' \
-d '{
    "contents": [
      {
        "type": "first_frame",
        "url": "https://p0.ssl.img.360kuai.com/dmfd/__60/t018b8fd959340b4f00.jpg"
      },
      {
        "type": "prompt",
        "text": "A golden retriever running on a sunny beach, cinematic lighting, slow motion"
      }
    ],
    "settings": {
      "resolution": "1080p",
      "duration": 8
    },
    "options": {
      “”
      "watermark_info": {
        "enabled": false
      }
    }
  }'

返回示例

{
    "code": 0,
    "message": "SUCCEED",
    "data": {
        "id": "901930004609634393",
        "status": "submitted",
        "message": "",
        "create_time": 1783065388949,
        "update_time": 1783065388949
    },
    "request_id": "ed6ce13d-7c9b-48cc-ba5c-e4ba5c260a60"
}

查询任务

请求URL

GET v1/ai/{endpointPath}/kling/tasks

请求参数

字段	类型	必填	默认值	描述
task_ids	string	选填	空	需要查询的系统定义的任务ID 查询任务时：请求路径参数，直接将值填写在请求路径中 task_ids与external_task_ids两种id至少且只能选择一种，不可同时使用支持批量查询
external_task_ids	string	选填	空	需要查询的自定义的任务ID 查询任务时：请求路径参数，直接将值填写在请求路径中 task_ids与external_task_ids两种id至少且只能选择一种，不可同时使用支持批量查询

请求示例

curl -g 'https://genaiapi-m2.cloudsway.net/v1/ai/{{endpointPath}}/kling/tasks?task_ids=899322227844730894&external_task_ids=' \
-H 'Authorization: Bearer {Your AK}' \
-H 'Content-Type: application/json' \

返回示例

{
    "code": 0,
    "message": "SUCCEED",
    "data": [
        {
            "id": "901930004609634393",
            "status": "succeeded",
            "message": "",
            "outputs": [
                {
                    "type": "video",
                    "id": "901930006506119262",
                    "url": "https://v16-kling-fdl.klingai.com/bs2/upload-ylab-stunt-sgp/muse/883866880053346352/VIDEO/20260703/94a3076d1a66898e3a3a72d01b4f2016-701d1905-6ece-42a4-9911-b048e59bbecb.mp4?cacheKey=ChtzZWN1cml0eS5rbGluZy5tZXRhX2VuY3J5cHQSsAFZz2jGsYSosbSWIP3R2XC-GYayNpXyFD3QJI6oBd0THyzVqA6pNW7qLVAiOYOK5ibt3ZOnlrrL9T6nH8GARsuFQBjFHbjH-ufnoUvlFUJ3jSKC34LLXDrqZ_TqEKI0W_ng2qL1TndbgTQcz6zd7GjkdFa8mByHjwuEIOAvw7JU3aJKNIPs4yl-F5APlBPB97XPOspwX5-jlreTRS7LqSG0CD5DHIvBa0uv6VfX4arL7xoSBJLSFVs3h7NB0bSL9MQcdiMhIiDEUHKJ1Ka4p2DZgIHNu7l8JSrFv_6vaIaPGk3K0J4o3SgFMAE&x-kcdn-pid=112781&ksSecret=8004a4f0fb0d97309d0549abd6d5f54e&ksTime=6a6ef86e",
                    "duration": "5.041"
                }
            ],
            "billing": [
                {
                    "amount": "5",
                    "charge_type": "unit",
                    "package_type": "video"
                }
            ],
            "create_time": 1783065388949,
            "update_time": 1783065455355
        }
    ],
    "request_id": "e508ec0e-feb7-4d18-815d-47b52a57cad7"
}