MaaS_KL_O3

能力地图

功能分类	子功能	std (3s \~ 15s)	pro (3s \~ 15s)	4k (3s \~ 15s)
文生视频	单镜头视频生成	✗	✓	✓
	多镜头视频生成	✓	✓	✓
	声音控制 (人声控制)	✗	✗	✗
图生视频	单镜头视频生成	✓	✓	✓
	多镜头视频生成	✓	✓	✓
	首尾帧 (一镜到底)	✓	✓	✓
	主体控制 (视频角色主体+多图主体)	✓	✓	✓
	视频参考	✓ (仅3s \~ 10s)	✓ (仅3s \~ 10s)	✗
	声音控制 (人声控制)	✗	✗	✗

功能分类	子功能	自定义长宽比（1K/2K/4K）	智能长宽比
文生图	单图生成	✓	✓
	其他	-	-
图生图	单图生成	✓	✓
	组图生成	✓	✓
	主体控制（仅多图主体）	✓	✓
	其他	-	-

请求协议

http

参数名	类型	描述
anthorization	string	鉴权

视频接口

创建视频生成任务接口

请求URL

https://genaiapi-m2.cloudsway.net/v1/ai/{endpoinPath}/kling/videos/omni-video

请求方法

POST

请求参数

字段	类型	必填	默认值	描述
`multi_shot`	boolean	可选	`false`	是否生成多镜头视频 ● 当前参数为 `true` 时，`prompt` 参数无效 ● 当前参数为 `false` 时，`shot_type` 参数及 `multi_prompt` 参数无效
`shot_type`	string	可选	空	分镜方式 ● 枚举值：`customize` ● 当 `multi_shot` 参数为 `true` 时，当前参数必填
`prompt`	string	可选	空	文本提示词，可包含正向描述和负向描述 ● 可将提示词模板化来满足不同的视频生成需求Omni模型可通过Prompt与主体、图片、视频等内容实现多种能力：通过 `<<<>>>` 的格式来指定某个主体、图片、视频，如：`<<<element_1>>>`、`<<<image_1>>>`、`<<<video_1>>>` ● 长度不能超过2500个字符 ● 当 "multi_shot 为 false "或" multi_shot参数为true且shot-type参数为intelligence"时，当前参数不得为空。不同模型版本支持能力范围不同，详见上文能力地图
`multi_prompt`	array	可选	空	各分镜信息，如提示词、时长等 ● 通过 `index`、`prompt`、`duration` 参数定义分镜序号及相应提示词和时长，其中： ○ 最多支持6个分镜，最小支持1个分镜 ○ 每个分镜相关内容的最大长度不超过512 ○ 每个分镜的时长不大于当前任务的总时长，不小于1 ○ 所有分镜的时长之和等于当前任务的总时长 ● 当 `multi_shot` 参数为 `true` 且 `shot_type` 参数为 `customize` 时，当前参数不得为空
`image_list`	array	可选	空	参考图列表 ● 包括主体、场景、风格等参考图片，也可作为首帧或尾帧生成视频；当作为首帧或尾帧生成视频时： ○ 通过 `type` 参数来定义图片是否为首尾帧：`first_frame` 为首帧，`end_frame` 为尾帧 ■ 暂时不支持仅尾帧，即有尾帧图时必须有首帧图 ○ 使用首帧或首尾帧生成视频时，不能使用视频编辑功能； ● 支持传入图片 Base64 编码或图片 URL（确保可访问） ● 图片格式支持 `.jpg` / `.jpeg` / `.png` ● 图片文件大小不能超过10MB，图片宽高尺寸不小于300px，图片宽高比要在 1:2.5 ~ 2.5:1 之间 ● 参考图片数量与有无参考视频、参考主体数量有关，其中： ○ 有参考视频时，参考图片数量和参考主体数量之和不得超过4； ○ 无参考视频时，参考图片数量和参考主体数量之和不得超过7； ○ 参考图片数量超过2时，不支持设置尾帧； ● `image_url` 参数值不得为空用key:value承载，如下： `"image_list":[ { "image_url":"image_url", "type":"first_frame" }, { "image_url":"image_url", "type":"end_frame" } ]` 不同模型版本支持能力范围不同，详见上文能力地图
`element_list`	array	可选	空	参考主体列表 ● 基于主体库中主体的 ID 配置，用key:value承载，如下： `"element_list":[ { "element_id":long }, { "element_id":long } ]` ● 参考主体数量与有无参考视频、参考图片数量有关，其中： ○ 如果使用首帧生视频或首尾帧生视频时，最多支持3个主体； ○ 有参考视频时，参考图片数量和参考主体数量之和不得超过4，且不支持使用视频角色主体； ○ 无参考视频时，参考图片数量和参考主体数量之和不得超过7 ● 主体分为视频定制主体（简称：视频角色主体）和图片定制主体（简称：多图主体），适用范围不同，请注意区分不同模型版本支持能力范围不同，详见上文能力地图
`video_list`	array	可选	空	参考视频，通过 URL 方式获取 ● 可作为特征参考视频，也可作为待编辑视频，默认为待编辑视频；可选择性保留视频原声 ○ 通过 `refer_type` 参数区分参考视频类型：`feature` 为特征参考视频，`base` 为待编辑视频 ○ 参考视频为待编辑视频时，不能定义视频首尾帧 ○ 通过 `keep_original_sound` 参数选择是否保留视频原声，`yes` 为保留，`no` 为不保留；当前参数对特征参考视频（`feature`）也生效 ● 有参考视频时，`sound` 参数值只能为 `off` ● 用key:value承载，如下： `"video_list":[ { "video_url":"video_url", "refer_type":"base", "keep_original_sound":"yes" } ]` ● 视频格式仅支持 MP4/MOV ● 视频时长不少于3秒，上限与模型版本有关，详见能力地图 ● 视频宽高尺寸需介于720px（含）和2160px（含）之间 ● 视频帧率基于24fps～60fps，生成视频时会输出为24fps ● 至多仅支持上传1段视频，视频大小不超过200MB ● `video_url` 参数值不得为空不同模型版本支持能力范围不同，详见上文能力地图
`sound`	string	可选	`off`	生成视频时是否同时生成声音 ● 枚举值：`on`，`off` 仅 V2.6 及后续版本模型支持当前参数
`mode`	string	可选	`pro`	生成视频的模式枚举值：std，pro，4k。其中： std：标准模式（标准），基础模式，性价比高，输出视频分辨率为720P pro：专家模式（高品质），高表现模式，生成视频质量更佳，输出视频分辨率为1080P。 4k：4K模式，高表现（同pro），生成视频质量更佳，输出视频分辨率为4K。不同模型版本支持能力范围不同，详见上文能力地图
`aspect_ratio`	string	可选	空	生成视频的画面纵横比（宽:高） ● 枚举值：`16:9`, `9:16`, `1:1` ● 未使用首帧参考或视频编辑功能时，当前参数必填指定首尾帧之后，aspect_ratio不生效，比例跟首帧一致
`duration`	string	可选	`5`	生成视频时长，单位 s ● 枚举值：3，4，5，6，7，8，9，10，11，12，13，14，15，其中： ○ 使用视频编辑功能（`"refer_type":"base"`）时，输出结果与传入视频时长相同，此时当前参数无效；此时，按输入视频时长四舍五入取整计量计费不同模型版本支持能力范围不同，详见上文能力地图
`watermark_info`	array	可选	空	是否同时生成含水印的结果 ● 通过 `enabled` 参数定义 ● 用key:value承载，如下：： `"watermark_info": { "enabled": boolean // true 为生成，false 为不生成 }` ● 暂不支持自定义水印
`external_task_id`	string	可选	空	自定义任务ID ● 用户自定义任务ID，传入不会覆盖系统生成的任务ID，但支持通过该ID进行任务查询 ● 请注意，单用户下需要保证唯一性

请求示例

curl --location --request POST 'https://genaiapi-m2.cloudsway.net/v1/ai/{Your endpoint}/kling/videos/omni-video' \
--header 'Authorization: Bearer XXX' \
--header 'Content-Type: application/json' \
--data-raw '{
    "multi_shot": true,
    "shot_type": "customize",
    "prompt": "",
    "multi_prompt": [
      {
        "index": 1,
        "prompt": "A person sitting on a park bench, sunlight filtering through trees.  Simple composition, no dialogue.",
        "duration": "2"
      },
      {
        "index": 2,
        "prompt": "A car speeding down a rainy street, headlights glowing.  Dynamic angle, focus on motion.",
        "duration": "3"
      }
    ],
    "image_list": [],
    "video_list": [],
    "mode": "pro",
    "sound": "on",
    "aspect_ratio": "16:9",
    "duration": 5,  
    "external_task_id": ""
  }'

返回值示例

{
    "code": 0,
    "message": "SUCCEED",
    "data": {
        "task_id": "868928128835022925",
        "task_status": "submitted",
        "created_at": 1775197128602,
        "updated_at": 1775197128602,
        "task_info": {
            "parent_video": null
        }
    },
    "request_id": "d1f782a3-be03-46fc-9f53-a076d5c0cb43"
}

查询视频任务接口

请求URL

https://genaiapi-m2.cloudsway.net/v1/ai/{endpoinPath}/kling/videos/omni-video/{id}

请求方法

GET

请求参数

字段	类型	必填	默认值	描述
task_id	string	可选	无	文生视频的任务ID请求路径参数，直接将值填写在请求路径中，与external_task_id两种查询方式二选一
external_task_id	string	可选	无	文生视频的自定义任务ID创建任务时填写的external_task_id，与task_id两种查询方式二选一

返回值示例

{
    "code": 0,
    "message": "SUCCEED",
    "data": {
        "task_id": "868928128835022925",
        "task_status": "succeed",
        "created_at": 1775197128602,
        "updated_at": 1775197273897,
        "task_status_msg": "",
        "task_info": {
            "parent_video": null
        },
        "task_result": {
            "videos": [
                {
                    "id": "868928128960864333",
                    "url": "https://v1-fdl.kechuangai.com/ksc2/78Bu8zqqtt8BvVYzSQJyvdTT8cXDcsf2l2qJcwzcoZAO23Gexgh_aWXSbIKKTud4MWrH3bWZZBJJAnnSyOejJVyJwPtevFHzp94Vj4cFuK9UjKKoYakSCeTgfl6HePBtj0p376KubNKD6J_Lzyv1C8PTz5rqHlqhtapd9LCLqf3N1aD4Tq3sTtDvCsYNUqm8aGiiQkrgUiCBunjnnInmtQ.mp4?cacheKey=ChtzZWN1cml0eS5rbGluZy5tZXRhX2VuY3J5cHQSsAHTBBOTkTWNGRvz5xTG0V28-Uq_QfOtUq4eGsTFRH0XGboJi1dI_XCj9OwEmUp7PRZ9a4IjmdF1km2p27yMyXgIIiG2XCZQIKNSaKuS8ZvCieMgxJviPQKg845UD39o2IA9162I6q4_tb4tG4SNQKKG2BmU-NHhuxB2EMK0tN7hNeT1qsBD5AdjGdld98KBw0Vk_NJSEcZ0OSO3B2pWvooQoG4O8d4UxuvgYimbgWyRbxoS0dDQ6WvEt8pqXaoyQyeDsp12IiAJ9zaeR6eoaHBvKGZpPW2onH-fp5fs1a9hhRqA5OOK0SgFMAE&x-kcdn-pid=112757&pkey=AAWyWoFyoVEsr4vdz3YL11tRkc-rMqwLU36FWc5M1u4o09zGmTpS7izTpBZZGAoLBffyoYFKWB0e2Jnq7wDd4DEW73rLytKoCBOyUCjzeZeK2G3N4U-hcMgln4JtmI0nPNc",
                    "duration": "5.041",
                    "watermark_url": null
                }
            ]
        },
        "final_unit_deduction": "5"
    },
    "request_id": "cf05377c-7abc-4c69-8920-056b1801397d"
}

图片生成

创建图片生成任务接口

请求URL

https://genaiapi-m2.cloudsway.net/v1/ai/{endpoinPath}/kling/images/omni-image

请求方法

POST

请求参数

字段	类型	必填	默认值	描述
`prompt`	string	必须	无	文本提示词，可包含正向描述和负向描述 ● 可将提示词模板化来满足不同的图像生成需求 ● 不能超过2500个字符
`image_list`	array	可选	空	参考图列表 ● 支持传入图片 Base64 编码或图片 URL（确保可访问） ● 图片格式支持 .jpg / .jpeg / .png ● 图片文件大小不能超过 10MB ● 图片宽高尺寸不小于 300px ● 图片宽高比要在 1:2.5 \~ 2.5:1 之间 ● 参考主体数量与参考图片数量有关，参考主体数量和参考图片数量之和不得超过 10 ● image_url 参数值不得为空
`element_list`	array	可选	空	主体参考列表 ● 基于主体库中主体的 ID 配置 ● 参考主体数量与参考图片数量有关，参考主体数量和参考图片数量之和不得超过 10
`resolution`	string	可选	`1k`	生成图片的清晰度 ● 枚举值：`1k`, `2k`, `4k` ○ `1k`：1K标清 ○ `2k`：2K高清 ○ `4k`：4K高清不同模型版本支持能力范围不同，详见上文能力地图
`result_type`	string	可选	`single`	生成结果单图/组图切换开关 ● 枚举值：`single`, `series` 不同模型版本支持范围不同，详见上文能力地图 ● 当 result_type 值为 series 时，当前参数无效
`n`	int	可选	`1`	生成图片数量 ● 取值范围：[1,9] ● 当 result_type 值为 series 时，当前参数无效
`series_amount`	int	可选	`4`	生成组图的图片数量 ● 取值范围：[2, 9] ● 当 result_type 值为 single 时，当前参数无效不同模型版本支持范围不同，详见上文能力地图
`aspect_ratio`	string	可选	`auto`	生成图片的画面纵横比（宽:高） ● 枚举值：`16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `3:2`, `2:3`, `21:9`, `auto` ○ 其中：auto 为根据传入内容智能生成视频 ○ 参考原图横纵比生成新图时，当前参数无效不同模型版本支持范围不同，详见上文能力地图
`watermark_info`	array	可选	空	是否同时生成含水印的结果 ● 通过 enabled 参数定义 ● 暂不支持自定义水印
`external_task_id`	string	可选	无	自定义任务ID ● 用户自定义任务ID，传入不会覆盖系统生成的任务ID，但支持通过该ID进行任务查询 ● 请注意，单用户下需要保证唯一性

请求示例

curl --location --request POST 'https://genaiapi-m2.cloudsway.net/v1/ai/{Your endpoint}/kling/images/omni-image' \
--header 'Authorization: Bearer XXX' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "Generate a recommended cover for each subject <<object_1>>",
    "element_list": [
      {
        "element_id": "171"
      },
      {
        "element_id": "168"
      }
    ],
    "image_list": [],
    "resolution": "2k",
    "result_type": "series",
    "series_amount": 2,
    "aspect_ratio": "auto",
    "external_task_id": ""
  }'

返回值示例

{
    "code": 0,
    "message": "SUCCEED",
    "data": {
        "task_id": "868615970234318861",
        "task_status": "submitted",
        "created_at": 1775122704188,
        "updated_at": 1775122704188,
        "task_info": {
            "parent_video": null
        }
    },
    "request_id": "6bb3c153-ad42-4b77-b47e-c93d00a03179"
}

查询图片任务接口

请求URL

https://genaiapi-m2.cloudsway.net/v1/ai/{endpoinPath}/kling/images/omni-image/{id}

请求方法

GET

请求参数

字段	类型	必填	默认值	描述
task_id	string	必须	无	图片生成的任务ID请求路径参数，直接将值填写在请求路径中

返回值示例

{
    "code": 0,
    "message": "SUCCEED",
    "data": {
        "task_id": "868615970234318861",
        "task_status": "succeed",
        "created_at": 1775122704188,
        "updated_at": 1775122766071,
        "task_status_msg": "",
        "task_info": {
            "parent_video": null
        },
        "task_result": {
            "images": [],
            "result_type": "series",
            "series_images": [
                {
                    "index": 0,
                    "url": "https://p4-fdl.klingai.com/ksc2/P2jeE3JrM6UCR0MLPbcSG_OElXt6gSr72Wfi-L4vsxUvgLxXnZs0eP8Oxts_BBZLXG2eoUJBvUKOH9RThrmv-BZtYayxkftN6fLNhGLY-QYZ2AK4zb7r0N80SxVuF82GSrgxVnbXEeDi3717Ucnz4LvDScRkYZe_iK94BPIGbR2PqP2Xb_Q0r5cU_0yfG-cRU6DKpY4b4J0qZleVgxhoYA.png?cacheKey=ChtzZWN1cml0eS5rbGluZy5tZXRhX2VuY3J5cHQSsAErbj-MxhrC42eaBwiAFabiUDxdo4oPwHZj4fyXp7hy2AugqWxn_7BIFOrIwDPOCAFWYxW0AGXYxzZVV-weFNeMuo9ZLP87Vw4y5QnwVg0g3Hw1w0BwWxxVvYNp77Gu4Yvj4uSVFTGEkNHDwyFayg-PJ41PM91Q-tUqTOkywmpuj8yrw-Z9NGsENgAdg1EWMI8Fa4S6UEnSb4XePuapYFDj1yHMQOwNMHnY8geaOkPyFRoSiK-SiyTQu2yvu8rTuMxr8vOaIiByGdRNv26eAn05JPN7tpsT_GAOPSQCSiQfh5v7f6ZzCCgFMAE&x-kcdn-pid=112757&pkey=AAVfrrRgjxtQu-rmceEw-n0m_3cLATL0VcNxCqF284bWZVokIb81gAKv9-KI1EP0dryvzLoRkxwy6mMr4T7ozVkOFpv_a8XO9k9CA__o74abDYOYwFsJwmAjnKs-k_YlZhc",
                    "watermark_url": null
                },
                {
                    "index": 1,
                    "url": "https://p2-fdl.klingai.com/ksc2/rWCvCx30utVQ7Il_Ia-Ugi6OxLB67Ii0noJKbLFJUhhrmfzwYn7RkAAA6Sp2xxImPpjriq3I7Ct3iTdhHc_6-hUZovAyz8oDwuXRc6aj6Yosk7ZtxaPzRMFky0SFafLvQmjXDS8_ZSglduEt4BNENXpzCo59Tbu4IAUCO_26kki31hFKeur7z3ZyfQILr-lmBqs7Fa-F63letx8PbO4ydg.png?cacheKey=ChtzZWN1cml0eS5rbGluZy5tZXRhX2VuY3J5cHQSsAHkMh90rdQQhwgg4eOelxRQR4skORZKNFoDwetwxRhF0Af3S8-0R3aPKqBEcIjcxUFgb8n36zw_djxJrmzzZCZDJ_ZvMgcwDTBX7S00RroqUcqqgDKGKJc0NfmclhZ_rPORaUxBTpHU4WHXaMy6RXEyZani_US5j1ovkQ5UXXp7uQ0fgG6h8yiy4cqRPcXABKCW_XcFd6Kx8fviONzmSUGu0vDYD8l2caIikdJT8qghTRoSK9DDR3Zts0AO39BBzVqoebvyIiBweZWLMu6ROzdvh2fZy7SdA8CVNFVV4CBrwYu-d0YpgigFMAE&x-kcdn-pid=112757&pkey=AAUlNpWne92A40ir-FNQnVyToczCQXitXf685fF_A-x1bVrCHRhMUONbEUOgAhR3sfAYLyTVsfg_iCeSkqzuf5UCQGS59c7hlAflcQC82_rWHR8aDpq1PwWNXB9MmVzYtVA",
                    "watermark_url": null
                }
            ]
        },
        "final_unit_deduction": "16"
    },
    "request_id": "75d3e7ec-1284-4419-9832-8607fda3096d"
}

文生音效

创建文生音效任务

请求URL

POST v1/ai/{endpointPath}/kling/audio/text-to-audio

请求参数

字段	类型	必填	默认值	描述
prompt	string	必填	无	文本提示词 • 内容长度不超过 200 字符
duration	float	必填	无	生成音频的时长 • 取值范围：3.0 秒至 10.0 秒，支持小数点后一位精度
external_task_id	string	可选	无	自定义任务 ID •用户自定义任务 ID，传入不会覆盖系统生成的任务 ID，但支持通过该 ID 进行任务查询 •请注意，单用户下需要保证唯一性
callback_url	string	可选	无	本次任务结果回调通知地址，如果配置，服务端会在任务状态发生变更时主动通知

请求示例

curl -g 'https://genaiapi-m2.cloudsway.net/v1/ai/{{endpointPath}}/kling/audio/text-to-audio' \
-H 'Authorization: Bearer {Your AK}' \
-H 'Content-Type: application/json' \
-d '{
    "prompt": "The sound of fireworks during Spring Festival celebrations.",
    "duration": 3,
    "external_task_id": "",
    "callback_url": ""
  }'

返回示例

{
    "code": 0,
    "message": "SUCCEED",
    "data": {
        "task_id": "871457979416604766",
        "task_status": "submitted",
        "created_at": 1775800291981,
        "updated_at": 1775800291981,
        "task_info": {}
    },
    "request_id": "828f9782-d2e1-4550-a36d-e715ae2ae037"
}

查询文生音效任务

请求URL

GET v1/ai/{endpointPath}/kling/audio/text-to-audio/{id}

task_id

文生音频的任务 ID:请求路径参数，直接将值填写在请求路径中,与 external_task_id 两种查询方式二选一

external_task_id

用户自定义任务ID。创建任务时填写的 external_task_id，与 task_id 两种查询方式二选一

请求示例

curl -g 'https://genaiapi-m2.cloudsway.net/v1/ai/{{endpointPath}}/kling/audio/text-to-audio/{id}' \
-H 'Authorization: Bearer {Your AK}' \
-H 'Content-Type: application/json'

返回示例

{
    "code": 0,
    "message": "SUCCEED",
    "data": {
        "task_id": "871457647223545935",
        "task_status": "succeed",
        "created_at": 1775800212780,
        "updated_at": 1775800228263,
        "task_status_msg": "",
        "task_info": {},
        "task_result": {
            "audios": [
                {
                    "id": "871457647265472604",
                    "url": null,
                    "duration": null,
                    "url_mp3": "https://v1-fdl.kechuangai.com/ksc2/ErHLIqeozb1WHdz1Izp1XGMBtJebQoG3Cp-2dvW1aWViY8RLKpP-tk5x7W6eeTn2b9GYO9YFP-o6znENuMnJ_gfCTlDfVz_FxCmXqGQ_q9-dhYwdNq2aZ8d7OHlPbYDwz0EsdeQnxcY_WktB6fbeiN5oHMdZZX8Uptz-fQGeBJWReQzcvLau7vxSQFcBf1rU1kGJZD3nRhuRJ-QT0NE0SA.mp3?cacheKey=ChtzZWN1cml0eS5rbGluZy5tZXRhX2VuY3J5cHQSsAFXEmxe-C5r1GsrJ4R_tFpMHnPrbjCJDG0KIp-dlRASzaKKVZPnTgDc4lOQw0tb7j0a6SuaZpiXsbq5v7GDhAdOjAaaMEFTIEhrKwILiBTZGoMM-l7cRD7Ak1Ijpt7KdddfiPC78jYKpRJEQVhp4DUtiyq8gzSrs6IOPskVBlbkMrhYZjRCYaJlswSacwFokyXfVoigHmoCox4tWOKtHuxwm5f_cNbqIxHkA6_Z19xqBhoSj4dfrTYhUzYe6jlYP2ZR__D3IiDmgbsrWNwPG28XCgRF7KfT3EKY6rUhktnmmeKY_OffqCgFMAE&x-kcdn-pid=112757&pkey=AAXEF3UtKZpRO5SOnZyIm1g87c3z1b0907OuSWpmsuDt4YCj95yjTniBUsV4LWeF5xlebOHfqK04MbbxPGXsyKVxpOqoVRq45ysb_TG_D6tKUSyb4zwibeQsYkSxRnmsFQw",
                    "url_wav": "https://v1-fdl.kechuangai.com/ksc2/ax60xYdmxPhWhrgqKcjG_R9nmqBtwZMYjs5jpC56Q5hVdN5Oae3O7d7kzmoEMhSJ-9Xv7-jrsi3v2DL0aHod0XOhTY8qoSofHRwh02DrXweWPL3JnQlUb13iVF2821muQ1O_-1-cbKUP1pg-QpQUOHvhd_FydZUe36F6bnvEW3E9AvbB95J6K0py-whjEerp2Z59LoNZAo2cHPtKS0ncHQ.wav?cacheKey=ChtzZWN1cml0eS5rbGluZy5tZXRhX2VuY3J5cHQSsAHMhoi-CYC9uUILiob74ZeXGkx3LSdWf7QCCBzpAdPiIjTaWxyhiErxhtb1mMQxCeT-YmlFsuqdVOJ73bXn5w7A6kLgO27kbl4uM5IjmZV5_dwTGhllwW_B2UXMdfwFxKIfRPu93U3-2M-Y3chNNOd0GhtUteZ9KIQn9Xc9bSpncu6HeNoMhIVm76XCDYyldt54EFfx8yLB51QV6LFCnnOtiAzbD-srIaG7HPJtH5j5tRoSqwnSbF-azU9cbKSOb8doGVG2IiAf7HRWbkMraGIU3pE62uCrWJoBkKaBwUWwUTOYw9nlhCgFMAE&x-kcdn-pid=112757&pkey=AAVm6lQUh6-ZOYrSRgFdt0zru0pJpiVxoeU820BANf98nNF4I4T8nG-q9lNdkw01UgQWYSR7L3cr6v6MVHiyN3UfBhNJJ9SFSS9f4E4z1eAlaLm8L8p3Ew6-nhILspq7oQU",
                    "duration_mp3": "3.056",
                    "duration_wav": "3.0"
                }
            ]
        },
        "final_unit_deduction": "0.25"
    },
    "request_id": "5571ddf9-0c33-44cd-8087-300bb47688ab"
}

视频生音效

请求URL

POST

https://genaiapi-m2.cloudsway.net/v1/ai/{endpointPath}/kling/audio/video-to-audio

请求参数

字段	类型	必填	默认值	描述
video_id	string	可选	空	通过可灵 AI 生成的视频的 ID 与 video_url 参数二选一填写，不能同时为空，也不能同时有值仅支持 30 天内生成并且长度在 3.0 秒-20.0 秒的视频
video_url	string	可选	无	所上传视频的获取链接与 video_id 参数二选一填写，不能同时为空，也不能同时有值视频格式仅支持 MP4/MOV，文件大小≤100M，视频长度在 3.0 秒-20.0 秒
sound_effect_prompt	string	可选	无	音效生成提示词不能超过 200 个字符
bgm_prompt	string	可选	无	配乐生成提示词 • 不能超过 200 个字符
asmr_mode	boolean	可选	false	是否开启 ASMR 模式；该模式会增强细节音效，适合高沉浸内容场景 • true 表示开启，false 表示关闭（默认值）
external_task_id	string	可选	无	自定义任务 ID 用户自定义任务 ID，传入不会覆盖系统生成的任务 ID，但支持通过该 ID 进行任务查询请注意，单用户下需要保证唯一性
callback_url	string	可选	无	本次任务结果回调通知地址，如果配置，服务端会在任务状态发生变更时主动通知

请求示例

curl -g 'https://genaiapi-m2.cloudsway.net/v1/ai/{{endpointPath}}/kling/audio/video-to-audio' \
-H 'Authorization: Bearer {Your AK}' \
-H 'Content-Type: application/json' \
-d '{
    "video_id": "",
    "video_url": "https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/20fps-7s.mov"
}'

返回示例

{
    "code": 0,
    "message": "SUCCEED",
    "data": {
        "task_id": "891066533651845201",
        "task_status": "submitted",
        "created_at": 1780475335623,
        "updated_at": 1780475335623,
        "task_info": {}
    },
    "request_id": "1a15fb7e-55d5-4671-a225-9b1255ec9eb9"
}

查询视频生音效任务

请求URL

GET

https://genaiapi-m2.cloudsway.net/v1/ai/{endpointPath}/kling/audio/video-to-audio/{taskId或external_task_id}

task_id

视频生音频的任务ID。直接在请求路径中填写值，与external_task_id两种查询方式二选一

external_task_id

视频生音频的自定义任务ID。创建任务时填写的 external_task_id，与 task_id 两种查询方式二选一

请求示例

curl -g 'https://genaiapi-m2.cloudsway.net/v1/ai/{endpointPath}/kling/audio/video-to-audio/{{taskId}}' \
-H 'Authorization: Bearer {Your AK}' \
-H 'Content-Type: application/json'

返回示例

{
    "code": 0,
    "message": "SUCCEED",
    "data": {
        "task_id": "891066533651845201",
        "task_status": "succeed",
        "created_at": 1780475335623,
        "updated_at": 1780475355352,
        "task_status_msg": "",
        "task_info": {},
        "task_result": {
            "videos": [
                {
                    "id": "891066533727334406",
                    "url": "https://v4-fdl.kechuangai.com/ksc2/pIhYL3dVgRzIZjbr_mtXwSnO-mFMOYpBNRZvVQr0GObbHXhyQDhajJlnZDkqRV1alXtac_YgQx_uhH3uzJi-Rl2O3PhQRC53fiO2e6WMDXGhmi7g815ttCePgbBJr6z-RhMdYsp5wa-z2LveqRW3PlDOZvf0Qq-MNXz2t2FKFrOMK0vM_ga0eXj5aNKw1v8bDqWEwkWWBOMw1KiI52s22A.mp4?cacheKey=ChtzZWN1cml0eS5rbGluZy5tZXRhX2VuY3J5cHQSsAE9x8atRoTH5Mm8dJVTPBZLhBcw_Mha80H5f9nLqZSyyVkmt278Cch2OoGX5WnCRTxhguD962gNNRRJh6GqG95WeL62ZbH4OyVac5yt5MpZWFVvhGZ5o6nqzaKspXv1rYwUi_F5TtN8EyBuf7xjTdtXhqkwOgmepBa-RkNyOIlYbYX_WkO4oDUrQJ9iqhoDCVDkKLakqWjuHbF6HTPXL5_fo6wOKzMky-u-xHTN409ERhoSxWNjcgh9zqt_zDfpYBGATs3tIiAtyQZsAVrEbrbUcgDLmT_oKIC4RtWIWNxbGPb2F2cj7ygFMAE&x-kcdn-pid=112757&pkey=AAWuEugjCUBB1hUq-78WXlTOZGpcujQAVkYLVnQHcauNei3PUvAGL_VCp-ioa7VVyUG0jKk6_8Nsk0VbhED1q32NkhjekLVU3C6XEVEzsy8sn8ncl0gGvWpccqGXiHGnqiw",
                    "duration": "7.0",
                    "watermark_url": null
                }
            ],
            "audios": [
                {
                    "id": "891066533727334406",
                    "url": null,
                    "duration": null,
                    "url_mp3": "https://v4-fdl.kechuangai.com/ksc2/PwKaNvs74inTwaGRNUdProeaqYxkIugHq5gxmpYuF6_Bq3Rf1mQXG6YFO1GWHpuux_M_Sq7eyygXymiWBdheb5RgOeIqzIjXUZp1n2vKXUmX8-_Ph8QY4EoO-4YXz-GCcnvRVuO3bfkMQRP5Sn9-wrlqb3RslzhBTR4RXz59YsudHcn9SMDt9n95pF0NvBQSMRDRD60d3FgziyO2FL00GQ.mp3?cacheKey=ChtzZWN1cml0eS5rbGluZy5tZXRhX2VuY3J5cHQSsAG0d3O0zrvQiT9L8RWEu1Muj6kvx9ZhRWtXfrK9GsRqNBMX2eHAvysY1TN-Gf5dFwZ3uTUcZhybVOpkbfjeCDsX8Jh0-xLczu5_bqqHjkLbE0Wq3x71Bg7wsD_LQULOa8H4paXWWeUQlnaHXfxZkUB1_0As-dTlO2Ay4qcuJfXs0EW0-CebKhss1hQ5_VpICcBUdDRBOwSZpQbc0WLtLKaExEUNm_4AUH0-Sag647P_-RoSMiIwzDkRLkXJDo0Gm30rVg5KIiAN9uUf-XIGCdk1R8J4MqPpc55XNjt2SAtWpGTkV-gSUSgFMAE&x-kcdn-pid=112757&pkey=AAWOvU4t_N2wGKGQnrz3Ojf_BAd8-paIRypiG16RNAmNKtLtuJfto1n4jb2O0DJtbmmYqD8AnFnHbNKbqPMQEvmv9FqQb04E2xWJ4RajKLQQ6GtG_BtFZNGbl-NQm3f0VXY",
                    "url_wav": "https://v4-fdl.kechuangai.com/ksc2/YoIKDuPlFzX1I-Cf6yKRsdfPqYSvtuuJyzK5zsPA9bjATb_bgqLvuVSiYA624nFvL5P791zgra7sZReQtXkKMDxrpkdSAxUzSXvaRshlICsS-bgPPL8PmsY_1Zb2C-u2-qaxtkyZxlVx9wxtPKDwtSsjCJzf8PgrpuQ69gs2qWKwdAyx0m8xSgyDVn5QIYm0SXQjBxalEgjS25gTqcbhJQ.wav?cacheKey=ChtzZWN1cml0eS5rbGluZy5tZXRhX2VuY3J5cHQSsAHyi8EXBD7LRGhnJQdr6JITxQVXu_UtDsMQlW_9wM0dngCmRBmK7WHZ7xhHfCsenk9l2DBVCNDSUmmNLI00mdJV6R4hmpVezOL4VSn4cNfA81oXGh9e4K51V2n8aJSeA34cBmp9FZqGpk9rQqSMVPYkOeMWDV_iu71__JP7McV2WIp2RujV8gH1vFZNdHFxtB39rULDv6Kzuv9QuyfHKtnQP4OEgHtRcqWh4C1wd3s1mxoS0TR4h_eyjkvDOmDeFijUb3cSIiCeTEUvJvuOmrYlWCnVkBacBuPhJJB2DczaSedIuGK0xygFMAE&x-kcdn-pid=112757&pkey=AAVg69bYbOPqLaRAif2WQE6bdN5BPIg7AlrRmVkHQhSGCXjOaMgWZXZIXvWpHMM4yTW3pJv1iDHJBKFLqANBJ8CAUxI8gn3N4y2ht52AEL1GLHkZ6hYIUrq81xQPnNBcK8Y",
                    "duration_mp3": "7.026",
                    "duration_wav": "6.96"
                }
            ]
        },
        "final_unit_deduction": "0.25"
    },
    "request_id": "7753c14c-26d0-4e3e-a12a-9bfff2737bef"
}

新主体功能

创建主体

请求url

POST v1/ai/{endpointPath}/kling/general/advanced-custom-elements

请求参数

字段	类型	必填	默认值	描述
element_name	string	必须	无	主体名称不能超过20个字符
element_description	string	必须	无	主体描述不能超过100个字符
reference_type	string	必须	无	主体参考方式枚举值：video_refer, image_refer video_refer: 视频角色主体，此时将参考element_video_list定义主体外表image_refer: 多图主体，此时将参考element_image_list定义主体外表通过视频定制的主体和通过图片定制的主体的可用范围不同，详见能力地图和参数说明。
element_image_list	array	可选	空	主体参考图，可通过多张图片设定主体及其细节包括正面参考图和其他角度或特写参考图，其中：至少包括1张正面参考图，由frontal_image参数定义需包括1～3张其他参考图，需与正面参考图有差异，由image_url参数定义用key:value承载，如下："element_image_list":{ "frontal_image":"image_url_0", "refer_images":[ { "image_url":"image_url_1" }, { "image_url":"image_url_2" }, { "image_url":"image_url_3" } ] } 支持传入图片Base64编码或图片URL（确保可访问）图片格式支持.jpg / .jpeg / .png图片文件大小不能超过10MB，图片宽高尺寸不小于300px，图片宽高比要在1:2.5 \~ 2.5:1之间 reference_type参数值为image_refer时，当前参数必填
element_video_list	array	可选	空	主体参考视频，可通过视频设定主体及其细节可上传有声视频，有声视频包含人声则触发音色定制（定制+入音色库+与主体绑定）参考视频时当前参数必填，参考图片时当前参数无效用key:value承载，如下："element_video_list":{ "refer_videos":[ { "video_url":"video_url_1" } ] } 视频格式仅支持MP4/MOV 仅支持时长介于3s～8s之间、宽高比例需为16:9或9:16的1080P视频至多仅支持上传1段视频，视频大小不超过200MB video_url参数值不得为空视频定制的主体仅支持用于kling-video-o3及之后的模型
element_voice_id	string	可选	空	主体音色，可绑定音色库中已有音色当前参数为空时，当前主体不绑定音色可通过音色相关API获取ID。仅视频定制的主体支持绑定音色
tag_list	array	可选	空	为主体配置标签，一个主体可以配置多个标签用key:value承载，其中具体如下："tag_list": [ { "tag_id": "o_101" }, { "tag_id": "o_102" } ] tag的ID与名称关系： ID 名称 o_101 热梗 o_102 人物 o_103 动物 o_104 道具 o_105 服饰 o_106 场景 o_107 特效 o_108 其他
callback_url	string	可选	无	本次任务结果回调通知地址，如果配置，服务端会在任务状态发生变更时主动通知具体通知的消息schema见“Callback协议”
external_task_id	string	可选	无	自定义任务ID用户自定义任务ID，传入不会覆盖系统生成的任务ID，但支持通过该ID进行任务查询请注意，单用户下需要保证唯一性

请求示例

图片定制

curl 'https://genaiapi-m2.cloudsway.net/v1/ai/{EndponintPath}/kling/general/advanced-custom-elements' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer {Your AK}' \
-d '{
    "element_name": "天台2",2
    "element_description": "天台",
    "reference_type": "image_refer",
    "element_image_list": {
        "frontal_image": "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/kling/element/%E5%A4%A9%E5%8F%B0-%E4%B8%BB%E8%A6%81%E5%8F%82%E8%80%83.jpeg?x-kcdn-pid=112452",
        "refer_images": [
            {
                "image_url": "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/kling/element/%E5%A4%A9%E5%8F%B0-%E5%85%B6%E4%BB%96%E5%8F%82%E8%80%831.png?x-kcdn-pid=112452"
            }
        ]
    },
    "external_task_id": "xiaosuelement3",
    "tag_list": [
        {
            "tag_id": "o_106"
        }
    ]
}'

视频定制

curl 'https://genaiapi-m2.cloudsway.net/v1/ai/{EndponintPath}/kling/general/advanced-custom-elements' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer {Your AK}' \
--data '{
    "element_name": "xxx",
    "element_description": "xxx",
    "reference_type": "video_refer",
    "element_video_list": {
        "refer_videos": [
            {
                "video_url": "xxx"
            }
        ]
    },
    "element_voice_id": string,
    "external_task_id": "",
    "tag_list": [
        {
            "tag_id": "xxx"
        }
    ]
}'

响应示例

{
    "code": 0,
    "message": "SUCCEED",
    "data": {
        "task_id": "xiaosuelement3",
        "task_status": "submitted",
        "created_at": 1771493684454,
        "updated_at": 1771493684454,
        "task_info": {
            "external_task_id": "xiaosuelement3"
        }
    },
    "request_id": "4f55d76d-be22-4ee0-9aca-8c37c5b625f6"
}

查询自定义主体（单个）

请求url

GET v1/ai/{endpointPath}/kling/general/advanced-custom-elements/{taskId}

请求路径参数

字段	类型	必填	默认值	描述
task_id	string	必须	无	图片生成的任务ID请求路径参数，直接将值填写在请求路径中

请求示例

curl 'https://genaiapi-m2.cloudsway.net/v1/ai/{EndponintPath}/kling/general/advanced-custom-elements/xiaosuelement3' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer {Your AK}'

响应示例

{
    "code": 0,
    "message": "SUCCEED",
    "data": {
        "task_id": "xiaosuelement3",
        "task_status": "succeed",
        "created_at": 1771493684454,
        "updated_at": 1771493687327,
        "task_status_msg": "",
        "task_info": {
            "external_task_id": "xiaosuelement3"
        },
        "task_result": {
            "elements": [
                {
                    "status": "succeed",
                    "element_id": 853394770105360422,
                    "element_name": "天台2",
                    "element_description": "天台",
                    "element_image_list": {
                        "frontal_image": "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/muse/766442945620226100/IMAGE/20260219/f47d607a5afab896277abc59076ab74c-dafee771-5394-412d-8f98-fd1b7d7eee95?x-kcdn-pid=112452",
                        "refer_images": [
                            {
                                "image_url": "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/muse/766442945620226100/IMAGE/20260219/97e217c20ec78b315660d2d2bece6466-50666a4c-cbd0-4b1f-9a9e-83269516c275?x-kcdn-pid=112452"
                            }
                        ]
                    },
                    "element_video_list": {},
                    "tag_list": [
                        {
                            "id": "o_106",
                            "name": "场景",
                            "description": "None"
                        }
                    ]
                }
            ]
        },
        "final_unit_deduction": "0"
    },
    "request_id": "e11555bd-7530-4eaf-a414-4a58ef89d188"
}

查询自定义主体（列表）

请求url

GET v1/ai/{endpointPath}/kling/general/advanced-custom-elements?pageNum=1\&pageSize=30

查询参数

字段	类型	必填	默认值	描述
pageNum	int	可选	1	页码取值范围：[1,1000]
pageSize	int	可选	30	每页数据量取值范围：[1,500]

请求示例

curl 'https://genaiapi-m2.cloudsway.net/v1/ai/{EndponintPath}/kling/general/advanced-custom-elements?pageNum=1&pageSize=30' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer {Your AK}'

响应示例

{
    "code": 0,
    "message": "SUCCEED",
    "data": [
        {
            "task_id": "xiaosuelement2",
            "task_status": "succeed",
            "created_at": 1771491754937,
            "updated_at": 1771491758169,
            "task_status_msg": "",
            "task_info": {
                "external_task_id": "xiaosuelement2"
            },
            "task_result": {
                "elements": [
                    {
                        "status": "deleted",
                        "element_id": 853386678537830428,
                        "element_name": "天台",
                        "element_description": "天台",
                        "element_image_list": {
                            "frontal_image": "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/muse/766442945620226100/IMAGE/20260219/f47d607a5afab896277abc59076ab74c-714228d5-7b8b-4be2-ae09-060cc78a4b94?x-kcdn-pid=112452",
                            "refer_images": [
                                {
                                    "image_url": "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/muse/766442945620226100/IMAGE/20260219/97e217c20ec78b315660d2d2bece6466-55e3a2e0-a87a-4c65-bd7f-841cfe2226fa?x-kcdn-pid=112452"
                                }
                            ]
                        },
                        "element_video_list": {},
                        "tag_list": [
                            {
                                "id": "o_106",
                                "name": "场景",
                                "description": "None"
                            }
                        ]
                    }
                ]
            },
            "final_unit_deduction": "0"
        },
        {
            "task_id": "xiaosuelement3",
            "task_status": "succeed",
            "created_at": 1771493684454,
            "updated_at": 1771493687327,
            "task_status_msg": "",
            "task_info": {
                "external_task_id": "xiaosuelement3"
            },
            "task_result": {
                "elements": [
                    {
                        "status": "succeed",
                        "element_id": 853394770105360422,
                        "element_name": "天台2",
                        "element_description": "天台",
                        "element_image_list": {
                            "frontal_image": "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/muse/766442945620226100/IMAGE/20260219/f47d607a5afab896277abc59076ab74c-dafee771-5394-412d-8f98-fd1b7d7eee95?x-kcdn-pid=112452",
                            "refer_images": [
                                {
                                    "image_url": "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/muse/766442945620226100/IMAGE/20260219/97e217c20ec78b315660d2d2bece6466-50666a4c-cbd0-4b1f-9a9e-83269516c275?x-kcdn-pid=112452"
                                }
                            ]
                        },
                        "element_video_list": {},
                        "tag_list": [
                            {
                                "id": "o_106",
                                "name": "场景",
                                "description": "None"
                            }
                        ]
                    }
                ]
            },
            "final_unit_deduction": "0"
        }
    ],
    "request_id": "0cc4f6f5-03fe-4269-8c01-c03460a6ff70"
}

查询官方主体列表

请求url

GET v1/ai/{endpointPath}/kling/general/advanced-presets-elements?pageNum=1\&pageSize=30

查询参数

字段	类型	必填	默认值	描述
pageNum	int	可选	1	页码取值范围：[1,1000]
pageSize	int	可选	30	每页数据量取值范围：[1,500]

请求示例

curl 'https://genaiapi-m2.cloudsway.net/v1/ai/{EndponintPath}/kling/general/advanced-presets-elements?pageNum=1&pageSize=30' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer {Your AK}'

响应示例

{
    "code": 0,
    "message": "SUCCEED",
    "data": [
        {
            "task_id": "171",
            "task_status": "succeed",
            "created_at": 0,
            "updated_at": 0,
            "task_status_msg": "",
            "task_info": {},
            "task_result": {
                "elements": [
                    {
                        "element_id": 171,
                        "element_name": "天台",
                        "element_description": "天台",
                        "element_image_list": {
                            "frontal_image": "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/kling/element/%E5%A4%A9%E5%8F%B0-%E4%B8%BB%E8%A6%81%E5%8F%82%E8%80%83.jpeg?x-kcdn-pid=112452",
                            "refer_images": [
                                {
                                    "image_url": "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/kling/element/%E5%A4%A9%E5%8F%B0-%E5%85%B6%E4%BB%96%E5%8F%82%E8%80%831.png?x-kcdn-pid=112452"
                                }
                            ]
                        },
                        "element_video_list": {
                            "refer_videos": null
                        },
                        "tag_list": [
                            {
                                "id": "o_106",
                                "name": "场景",
                                "description": "None"
                            }
                        ]
                    }
                ]
            }
        }
  ],
  "request_id": "7dcc4595-b014-4203-98e0-9168e76aaf79"
}

删除自定义主体

请求url

POST v1/ai/{endpointPath}/kling/general/delete-advanced-elements

请求体

字段	类型	必填	默认值	描述
element_id	string	必须	无	要删除的主体ID，仅支持删除自定义主体

请求示例

curl 'https://genaiapi-m2.cloudsway.net/v1/ai/{EndponintPath}/kling/general/delete-advanced-elements' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer {Your AK}' \
-d '{
    "element_id": "853386678537830428"
}'

响应示例

{
    "code": 0,
    "message": "SUCCEED",
    "request_id": "00e614fd-242b-41c9-a7e4-59b9baf048a1"
}

MaaS_KL_O3

能力地图

请求协议

Header

视频接口

创建视频生成任务接口

请求URL

请求方法

请求参数

请求示例

返回值示例

查询视频任务接口

请求URL

请求方法

请求参数

返回值示例

图片生成

创建图片生成任务接口

请求URL

请求方法

请求参数

请求示例

返回值示例

查询图片任务接口

请求URL

请求方法

请求参数

返回值示例

文生音效

创建文生音效任务

请求URL

请求参数

请求示例

返回示例

查询文生音效任务

请求URL

请求示例

返回示例

视频生音效

请求URL

请求参数

请求示例

返回示例

查询视频生音效任务

请求URL

请求示例

返回示例

新主体功能

创建主体

请求url

请求参数

请求示例

响应示例

查询自定义主体（单个）

请求url

请求路径参数

请求示例

响应示例

查询自定义主体（列表）

请求url

查询参数

请求示例

响应示例

查询官方主体列表

请求url

查询参数

请求示例

响应示例

删除自定义主体

请求url

请求体

请求示例

响应示例