跳到主要内容

图像识别

PinduCloud 提供本页所列接口。请求使用 PinduCloud API Key;模型开通情况以当前账号的可用模型为准,参数按本页对应型号的协议组织。

POST 创建或管理请求可通过 model_name 选择账号已开通的可灵型号;未传时读取 model,两者都省略时使用 kling-v1。即使接口参数表未列出模型字段,也需确保账号已开通所选型号及对应能力。

图像识别​

POST https://video.pinducloud.com.cn/kling/v1/videos/image-recognize

请求头​

参数类型必填默认值说明
Content-Typestring是application/json数据交换格式
Authorizationstring是Bearer sk-your-pinducloud-token,使用 PinduCloud API Key

请求体​

参数类型必填默认值说明
imagestring是待识别的图片
支持传入图片Base64编码或图片URL(确保可访问)
请注意,若您使用base64的方式,请确保您传递的所有图像数据参数均采用Base64编码格式。在提交数据时,请不要在Base64编码字符串前添加任何前缀,例如data:image/png;base64,。正确的参数格式应该直接是Base64编码后的字符串。请仅提供Base64编码的字符串部分,以便系统能够正确处理和解析您的数据。
图片格式支持.jpg / .jpeg / .png。图片文件大小不能超过10MB,图片宽高尺寸不小于300px,图片宽高比介于1:2.5 ~ 2.5:1之间

请求示例​

curl --request POST \
--url https://video.pinducloud.com.cn/kling/v1/videos/image-recognize \
--header 'Authorization: Bearer sk-your-pinducloud-token' \
--header 'Content-Type: application/json' \
--data '{
"image": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-1.png"
}'

响应示例​

{
"code": 0, // 错误码;错误详情见 message 字段
"message": "string", // 错误信息
"request_id": "string", // 请求ID,系统生成,用于跟踪请求、排查问题
"data": {
"task_result": {
"images": [
{
"type": "object_seg", // 主体识别结果标识
"is_contain": true, // 是否识别到主体;布尔值
"url": "string" //识别后图片的URL,例如https://p1.a.kwimgs.com/bs2/upload-ylab-stunt/special-effect/output/HB1_PROD_ai_web_46554461/-2878350957757294165/output.png(请注意,为下载地址可能有有效期,请及时转存)
},
{
"type": "head_seg", // 含头发的人物面部识别结果标识
"is_contain": true, // 是否识别到主体;布尔值
"url": "string" //识别后图片的URL,例如https://p1.a.kwimgs.com/bs2/upload-ylab-stunt/special-effect/output/HB1_PROD_ai_web_46554461/-2878350957757294165/output.png(请注意,为下载地址可能有有效期,请及时转存)
},
{
"type": "face_seg", // 不含头发的人物面部识别结果标识
"is_contain": true, // 是否识别到主体;布尔值
"url": "string" //识别后图片的URL,例如https://p1.a.kwimgs.com/bs2/upload-ylab-stunt/special-effect/output/HB1_PROD_ai_web_46554461/-2878350957757294165/output.png(请注意,为下载地址可能有有效期,请及时转存)
},
{
"type": "cloth_seg", // 服装识别结果标识
"is_contain": true, // 是否识别到主体;布尔值
"url": "string" //识别后图片的URL,例如https://p1.a.kwimgs.com/bs2/upload-ylab-stunt/special-effect/output/HB1_PROD_ai_web_46554461/-2878350957757294165/output.png(请注意,为下载地址可能有有效期,请及时转存)
}
]
},
"final_unit_deduction": "string" // 任务服务原生积分信息;本站实际扣费以使用日志为准
}
}