Skip to main content
POST
/
kling
/
v1
/
videos
/
image-recognize
cURL
curl --request POST \
+  --url https://api.deerapi.com/kling/v1/videos/image-recognize \
+  --header 'Authorization: Bearer <DEERAPI_KEY>' \
+  --header 'Content-Type: application/json' \
+  --data '{
    "image": "https://example.com/person-photo.png"
  }'
{
  "code": 123,
  "message": "<string>",
  "request_id": "<string>",
  "data": {
    "final_unit_deduction": "<string>",
    "task_result": {
      "images": [
        {
          "type": "<string>",
          "is_contain": true,
          "url": "<string>"
        }
      ]
    }
  }
}
/kling/v1/videos/image-recognize 是一个预处理接口。它直接返回分割和识别结果，适合给试穿、主体裁切、抠图和运营后台审核做前置判断，不适合当成生成接口来理解。
这条能力通常直接返回 task_result.images，不是典型的长任务轮询页。

​
最小调用思路

  • 首个请求只传 image。
  • 第一次接入优先用可访问的图片 URL 验证结果，再切到 Base64。
  • 输入图片的格式、尺寸和宽高比建议在业务侧先做预检，减少失败重试。

​
读结果时先看什么

  • type：区分 object_seg、head_seg、face_seg、cloth_seg。
  • is_contain：判断是否识别到对应主体。
  • url：拿到实际分割结果图。

​
常见误解

  • 把图像识别接口当成图像生成或编辑接口。
  • 以为每次都会返回所有类型的分割结果。
  • 没做输入预检，结果把格式或尺寸错误误判成模型问题。

​
相关页面

  • 虚拟试穿：试穿前需要先做服饰或人物识别时可先走这页。
  • 扩图：需要在已有图片基础上扩边时改走这里。
  • 图像生成：需要从零生成新图时不要用识别接口。

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Use your DeerAPI key.

Headers

​
Content-Type
string

Body

application/json

如果你使用 Base64，请只传 <BASE64_IMAGE_DATA>，不要附带 data:image/...;base64, 前缀。

​
image
string
default:example
required

待识别图片。支持可访问的图片 URL 或原始 Base64 编码。若使用 Base64，请只传 <BASE64_IMAGE_DATA>，不要附带 data:image/...;base64, 前缀。图片格式支持 .jpg / .jpeg / .png，大小不超过 10MB，宽高不小于 300px，宽高比需在 1:2.5 到 2.5:1 之间。

Response

200 - application/json

识别完成，直接返回 task_result.images。不同识别类型会以 type 字段区分。

​
code
integer
required

返回码。

​
message
string
required

错误信息或成功说明。

​
request_id
string
required

请求唯一标识。

​
data
object
required