获取图片特征和结构化详情信息

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String RecognizeImage

系统规定参数。取值:RecognizeImage。

CorpId String 123

项目 id

ImageContent String iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAACZUlEQVQ4T42TX2hSURzHf+feq1OnaDFIF42uWougkNSH3XDWxgraQ0RImdQwofcgih5GT7Uoas8xm9UyAgdRjyNClJYs/xEELlY5w2ZlpJtM5/0X95aiqdV5OnDO+dzf7/v7XAT/XggA+E7XhMOmZTKZtqvl2CuZhFeUq7wSIcRLcW61wmKVtTJPJZPJdOODJoDVanXjGEwFXGlcKaGBwJo/POw1cAwLnng8fq8GqQOsVqv96ZmPQZZHcH2e/H7Lo/uGYYSWF8rnmc/jM7m+cSqlEh7a7xgG4/F4WNiLALPZ3COToJXHp5aJ2ws7ixNurbqlNwCgLqYheG4JRryGKs2hrbFYLC/eGxww5/zOzJbJ18bSFVevUkaw7TNDOFyYyuSvHXzXM+rTfwlFEloRMLTftHr/RFaFb6MWN6mIfoyjgfmagidv5CLo2N4yENrdAAgHnmNS9IfgrqMPyNKLl0mVCLANmNlHzgzWRdoKagXSAEsDdTkL0WhUBPgvmcBxiBQBCKCwsfRcc8Sn58KRBC4CDlBmZuZkBpfrbQWV/P8Aoz6SC0WSvwAjNtOPaUdWQ/RRi5tVRH+tgloQofNrLS0cf0gW58JJze8Q9634nZ+0QohXx3qVQgYtC8PEFhpCzIUiCZ0IEOzrkhDvZ08vY5MLO4oTbp263RhqYxz2GtkqzRoFK+vjtlgsZ5+Npe8KIt2YJ/M3Pbr8X0Ry12z8U2U7gfNzs660tFvCAI6aVT48bWAqNAzVLKyb2FiuYGW3lH8rwUGxwfAK4UyKQYnm0Po6jfYI9nX8mdr17XA48EAg0EFNgJ/jCg8gGGphCgAAAABJRU5ErkJggg==

图片 base64数据,base64后的数据不可超过5M。

ImageContent、ImageUrl必须提供一个,如果都提供,只优先使用 ImageContent。

ImageUrl String http://www.aliyun.com

图片访问的 url,图片内容数据不可超过5M。

ImageContent、ImageUrl必须提供一个,如果都提供,只优先使用 ImageContent。

Vendor String damo

算法提供商,默认 damo

可选值:damo/yushiadb

RecognizeType String Face

结构化类型

可选值:Face 人脸,Body 人体

默认为空,代表对人脸、人体全部类型进行结构化

RequireCropImage Boolean false

是否需要在响应结果里面,返回目标图片裁剪后的 base64内容

默认为 false

返回数据

名称 类型 示例值 描述
Code String Success

响应 code

Data Struct

返回详情

BodyList Array of BodyList

识别出的人体列表

CropAlgorithmCode String code1

得出该结果的扣图算法 code

Feature String [-0.04595605,-0.0038912394,-0.012384229]

识别结果的特征向量值

格式为 List<Float>对象json 序列化后的字符串内容

LeftTopX Integer 489

目标图在原图上的左上角X轴坐标

LeftTopY Integer 600

目标图在原图上的左上角Y轴坐标

RightBottomX Integer 10

目标图在原图上的右下角X轴坐标

RightBottomY Integer 20

目标图在原图上的右下角Y轴坐标

TargetImageContent String iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAACZUlEQVQ4T42TX2hSURzHf+feq1OnaDFIF42uWougkNSH3XDWxgraQ0RImdQwofcgih5GT7Uoas8xm9UyAgdRjyNClJYs/xEELlY5w2ZlpJtM5/0X95aiqdV5OnDO+dzf7/v7XAT/XggA+E7XhMOmZTKZtqvl2CuZhFeUq7wSIcRLcW61wmKVtTJPJZPJdOODJoDVanXjGEwFXGlcKaGBwJo/POw1cAwLnng8fq8GqQOsVqv96ZmPQZZHcH2e/H7Lo/uGYYSWF8rnmc/jM7m+cSqlEh7a7xgG4/F4WNiLALPZ3COToJXHp5aJ2ws7ixNurbqlNwCgLqYheG4JRryGKs2hrbFYLC/eGxww5/zOzJbJ18bSFVevUkaw7TNDOFyYyuSvHXzXM+rTfwlFEloRMLTftHr/RFaFb6MWN6mIfoyjgfmagidv5CLo2N4yENrdAAgHnmNS9IfgrqMPyNKLl0mVCLANmNlHzgzWRdoKagXSAEsDdTkL0WhUBPgvmcBxiBQBCKCwsfRcc8Sn58KRBC4CDlBmZuZkBpfrbQWV/P8Aoz6SC0WSvwAjNtOPaUdWQ/RRi5tVRH+tgloQofNrLS0cf0gW58JJze8Q9634nZ+0QohXx3qVQgYtC8PEFhpCzIUiCZ0IEOzrkhDvZ08vY5MLO4oTbp263RhqYxz2GtkqzRoFK+vjtlgsZ5+Npe8KIt2YJ/M3Pbr8X0Ry12z8U2U7gfNzs660tFvCAI6aVT48bWAqNAzVLKyb2FiuYGW3lH8rwUGxwfAK4UyKQYnm0Po6jfYI9nX8mdr17XA48EAg0EFNgJ/jCg8gGGphCgAAAABJRU5ErkJggg==

目标图片的base64编码内容

只有在 CropImageContent=true 时,才有结果

FaceList Array of FaceList

识别出的人脸列表

CropAlgorithmCode String code1

识别出的人体列表

FaceKeyPointQuality Float 0.75

人脸关键点质量分

FaceQuality Float 0.85

人脸质量分

Feature String [-0.04595605,-0.0038912394,-0.012384229]

识别结果的特征向量值

格式为 List<Float>对象json 序列化后的内容

LeftTopX Integer 600

目标图在原图上的左上角X轴坐标

LeftTopY Integer 20

目标图在原图上的左上角Y轴坐标

RightBottomX Integer 10

目标图在原图上的右下角X轴坐标

RightBottomY Integer 50

目标图在原图上的右下角Y轴坐标

TargetImageContent String iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAACZUlEQVQ4T42TX2hSURzHf+feq1OnaDFIF42uWougkNSH3XDWxgraQ0RImdQwofcgih5GT7Uoas8xm9UyAgdRjyNClJYs/xEELlY5w2ZlpJtM5/0X95aiqdV5OnDO+dzf7/v7XAT/XggA+E7XhMOmZTKZtqvl2CuZhFeUq7wSIcRLcW61wmKVtTJPJZPJdOODJoDVanXjGEwFXGlcKaGBwJo/POw1cAwLnng8fq8GqQOsVqv96ZmPQZZHcH2e/H7Lo/uGYYSWF8rnmc/jM7m+cSqlEh7a7xgG4/F4WNiLALPZ3COToJXHp5aJ2ws7ixNurbqlNwCgLqYheG4JRryGKs2hrbFYLC/eGxww5/zOzJbJ18bSFVevUkaw7TNDOFyYyuSvHXzXM+rTfwlFEloRMLTftHr/RFaFb6MWN6mIfoyjgfmagidv5CLo2N4yENrdAAgHnmNS9IfgrqMPyNKLl0mVCLANmNlHzgzWRdoKagXSAEsDdTkL0WhUBPgvmcBxiBQBCKCwsfRcc8Sn58KRBC4CDlBmZuZkBpfrbQWV/P8Aoz6SC0WSvwAjNtOPaUdWQ/RRi5tVRH+tgloQofNrLS0cf0gW58JJze8Q9634nZ+0QohXx3qVQgYtC8PEFhpCzIUiCZ0IEOzrkhDvZ08vY5MLO4oTbp263RhqYxz2GtkqzRoFK+vjtlgsZ5+Npe8KIt2YJ/M3Pbr8X0Ry12z8U2U7gfNzs660tFvCAI6aVT48bWAqNAzVLKyb2FiuYGW3lH8rwUGxwfAK4UyKQYnm0Po6jfYI9nX8mdr17XA48EAg0EFNgJ/jCg8gGGphCgAAAABJRU5ErkJggg==

目标图片的base64编码内容

只有在 CropImageContent=true 时,才有结果

Message String OK

响应 message

RequestId String 46329898-489C-4E63-9BA1-C1DA5C5D0986

请求 id

Success String true

是否请求成功

示例

请求示例

http(s)://[Endpoint]/?Action=RecognizeImage
&CorpId=123
&ImageContent=iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAACZUlEQVQ4T42TX2hSURzHf+feq1OnaDFIF42uWougkNSH3XDWxgraQ0RImdQwofcgih5GT7Uoas8xm9UyAgdRjyNClJYs/xEELlY5w2ZlpJtM5/0X95aiqdV5OnDO+dzf7/v7XAT/XggA+E7XhMOmZTKZtqvl2CuZhFeUq7wSIcRLcW61wmKVtTJPJZPJdOODJoDVanXjGEwFXGlcKaGBwJo/POw1cAwLnng8fq8GqQOsVqv96ZmPQZZHcH2e/H7Lo/uGYYSWF8rnmc/jM7m+cSqlEh7a7xgG4/F4WNiLALPZ3COToJXHp5aJ2ws7ixNurbqlNwCgLqYheG4JRryGKs2hrbFYLC/eGxww5/zOzJbJ18bSFVevUkaw7TNDOFyYyuSvHXzXM+rTfwlFEloRMLTftHr/RFaFb6MWN6mIfoyjgfmagidv5CLo2N4yENrdAAgHnmNS9IfgrqMPyNKLl0mVCLANmNlHzgzWRdoKagXSAEsDdTkL0WhUBPgvmcBxiBQBCKCwsfRcc8Sn58KRBC4CDlBmZuZkBpfrbQWV/P8Aoz6SC0WSvwAjNtOPaUdWQ/RRi5tVRH+tgloQofNrLS0cf0gW58JJze8Q9634nZ+0QohXx3qVQgYtC8PEFhpCzIUiCZ0IEOzrkhDvZ08vY5MLO4oTbp263RhqYxz2GtkqzRoFK+vjtlgsZ5+Npe8KIt2YJ/M3Pbr8X0Ry12z8U2U7gfNzs660tFvCAI6aVT48bWAqNAzVLKyb2FiuYGW3lH8rwUGxwfAK4UyKQYnm0Po6jfYI9nX8mdr17XA48EAg0EFNgJ/jCg8gGGphCgAAAABJRU5ErkJggg==
&ImageUrl=http://www.aliyun.com
&Vendor=damo
&<公共请求参数>

正常返回示例

XML格式

<RequestId>46329898-489C-4E63-9BA1-C1DA5C5D0986</RequestId>
<Message>OK</Message>
<Data>
    <BodyList>
        <RightBottomX>10</RightBottomX>
        <RightBottomY>20</RightBottomY>
        <CropAlgorithmCode>code1</CropAlgorithmCode>
        <LeftTopY>600</LeftTopY>
        <TargetImageContent>iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAACZUlEQVQ4T42TX2hSURzHf+feq1OnaDFIF42uWougkNSH3XDWxgraQ0RImdQwofcgih5GT7Uoas8xm9UyAgdRjyNClJYs/xEELlY5w2ZlpJtM5/0X95aiqdV5OnDO+dzf7/v7XAT/XggA+E7XhMOmZTKZtqvl2CuZhFeUq7wSIcRLcW61wmKVtTJPJZPJdOODJoDVanXjGEwFXGlcKaGBwJo/POw1cAwLnng8fq8GqQOsVqv96ZmPQZZHcH2e/H7Lo/uGYYSWF8rnmc/jM7m+cSqlEh7a7xgG4/F4WNiLALPZ3COToJXHp5aJ2ws7ixNurbqlNwCgLqYheG4JRryGKs2hrbFYLC/eGxww5/zOzJbJ18bSFVevUkaw7TNDOFyYyuSvHXzXM+rTfwlFEloRMLTftHr/RFaFb6MWN6mIfoyjgfmagidv5CLo2N4yENrdAAgHnmNS9IfgrqMPyNKLl0mVCLANmNlHzgzWRdoKagXSAEsDdTkL0WhUBPgvmcBxiBQBCKCwsfRcc8Sn58KRBC4CDlBmZuZkBpfrbQWV/P8Aoz6SC0WSvwAjNtOPaUdWQ/RRi5tVRH+tgloQofNrLS0cf0gW58JJze8Q9634nZ+0QohXx3qVQgYtC8PEFhpCzIUiCZ0IEOzrkhDvZ08vY5MLO4oTbp263RhqYxz2GtkqzRoFK+vjtlgsZ5+Npe8KIt2YJ/M3Pbr8X0Ry12z8U2U7gfNzs660tFvCAI6aVT48bWAqNAzVLKyb2FiuYGW3lH8rwUGxwfAK4UyKQYnm0Po6jfYI9nX8mdr17XA48EAg0EFNgJ/jCg8gGGphCgAAAABJRU5ErkJggg==</TargetImageContent>
        <Feature>[-0.04595605,-0.0038912394,-0.012384229]</Feature>
        <LeftTopX>489</LeftTopX>
    </BodyList>
    <FaceList>
        <FaceQuality>0.85</FaceQuality>
        <RightBottomX>10</RightBottomX>
        <FaceKeyPointQuality>0.75</FaceKeyPointQuality>
        <RightBottomY>50</RightBottomY>
        <CropAlgorithmCode>code1</CropAlgorithmCode>
        <LeftTopY>20</LeftTopY>
        <TargetImageContent>iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAACZUlEQVQ4T42TX2hSURzHf+feq1OnaDFIF42uWougkNSH3XDWxgraQ0RImdQwofcgih5GT7Uoas8xm9UyAgdRjyNClJYs/xEELlY5w2ZlpJtM5/0X95aiqdV5OnDO+dzf7/v7XAT/XggA+E7XhMOmZTKZtqvl2CuZhFeUq7wSIcRLcW61wmKVtTJPJZPJdOODJoDVanXjGEwFXGlcKaGBwJo/POw1cAwLnng8fq8GqQOsVqv96ZmPQZZHcH2e/H7Lo/uGYYSWF8rnmc/jM7m+cSqlEh7a7xgG4/F4WNiLALPZ3COToJXHp5aJ2ws7ixNurbqlNwCgLqYheG4JRryGKs2hrbFYLC/eGxww5/zOzJbJ18bSFVevUkaw7TNDOFyYyuSvHXzXM+rTfwlFEloRMLTftHr/RFaFb6MWN6mIfoyjgfmagidv5CLo2N4yENrdAAgHnmNS9IfgrqMPyNKLl0mVCLANmNlHzgzWRdoKagXSAEsDdTkL0WhUBPgvmcBxiBQBCKCwsfRcc8Sn58KRBC4CDlBmZuZkBpfrbQWV/P8Aoz6SC0WSvwAjNtOPaUdWQ/RRi5tVRH+tgloQofNrLS0cf0gW58JJze8Q9634nZ+0QohXx3qVQgYtC8PEFhpCzIUiCZ0IEOzrkhDvZ08vY5MLO4oTbp263RhqYxz2GtkqzRoFK+vjtlgsZ5+Npe8KIt2YJ/M3Pbr8X0Ry12z8U2U7gfNzs660tFvCAI6aVT48bWAqNAzVLKyb2FiuYGW3lH8rwUGxwfAK4UyKQYnm0Po6jfYI9nX8mdr17XA48EAg0EFNgJ/jCg8gGGphCgAAAABJRU5ErkJggg==</TargetImageContent>
        <Feature>[-0.04595605,-0.0038912394,-0.012384229]</Feature>
        <LeftTopX>600</LeftTopX>
    </FaceList>
</Data>
<Code>Success</Code>
<Success>true</Success>

JSON格式

{
    "RequestId": "46329898-489C-4E63-9BA1-C1DA5C5D0986",
    "Message": "OK",
    "Data": {
        "BodyList": {
            "RightBottomX": 10,
            "RightBottomY": 20,
            "CropAlgorithmCode": "code1",
            "LeftTopY": 600,
            "TargetImageContent": "iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAACZUlEQVQ4T42TX2hSURzHf+feq1OnaDFIF42uWougkNSH3XDWxgraQ0RImdQwofcgih5GT7Uoas8xm9UyAgdRjyNClJYs/xEELlY5w2ZlpJtM5/0X95aiqdV5OnDO+dzf7/v7XAT/XggA+E7XhMOmZTKZtqvl2CuZhFeUq7wSIcRLcW61wmKVtTJPJZPJdOODJoDVanXjGEwFXGlcKaGBwJo/POw1cAwLnng8fq8GqQOsVqv96ZmPQZZHcH2e/H7Lo/uGYYSWF8rnmc/jM7m+cSqlEh7a7xgG4/F4WNiLALPZ3COToJXHp5aJ2ws7ixNurbqlNwCgLqYheG4JRryGKs2hrbFYLC/eGxww5/zOzJbJ18bSFVevUkaw7TNDOFyYyuSvHXzXM+rTfwlFEloRMLTftHr/RFaFb6MWN6mIfoyjgfmagidv5CLo2N4yENrdAAgHnmNS9IfgrqMPyNKLl0mVCLANmNlHzgzWRdoKagXSAEsDdTkL0WhUBPgvmcBxiBQBCKCwsfRcc8Sn58KRBC4CDlBmZuZkBpfrbQWV/P8Aoz6SC0WSvwAjNtOPaUdWQ/RRi5tVRH+tgloQofNrLS0cf0gW58JJze8Q9634nZ+0QohXx3qVQgYtC8PEFhpCzIUiCZ0IEOzrkhDvZ08vY5MLO4oTbp263RhqYxz2GtkqzRoFK+vjtlgsZ5+Npe8KIt2YJ/M3Pbr8X0Ry12z8U2U7gfNzs660tFvCAI6aVT48bWAqNAzVLKyb2FiuYGW3lH8rwUGxwfAK4UyKQYnm0Po6jfYI9nX8mdr17XA48EAg0EFNgJ/jCg8gGGphCgAAAABJRU5ErkJggg==",
            "Feature": "[-0.04595605,-0.0038912394,-0.012384229]",
            "LeftTopX": 489
        },
        "FaceList": {
            "FaceQuality": 0.85,
            "RightBottomX": 10,
            "FaceKeyPointQuality": 0.75,
            "RightBottomY": 50,
            "CropAlgorithmCode": "code1",
            "LeftTopY": 20,
            "TargetImageContent": "iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAACZUlEQVQ4T42TX2hSURzHf+feq1OnaDFIF42uWougkNSH3XDWxgraQ0RImdQwofcgih5GT7Uoas8xm9UyAgdRjyNClJYs/xEELlY5w2ZlpJtM5/0X95aiqdV5OnDO+dzf7/v7XAT/XggA+E7XhMOmZTKZtqvl2CuZhFeUq7wSIcRLcW61wmKVtTJPJZPJdOODJoDVanXjGEwFXGlcKaGBwJo/POw1cAwLnng8fq8GqQOsVqv96ZmPQZZHcH2e/H7Lo/uGYYSWF8rnmc/jM7m+cSqlEh7a7xgG4/F4WNiLALPZ3COToJXHp5aJ2ws7ixNurbqlNwCgLqYheG4JRryGKs2hrbFYLC/eGxww5/zOzJbJ18bSFVevUkaw7TNDOFyYyuSvHXzXM+rTfwlFEloRMLTftHr/RFaFb6MWN6mIfoyjgfmagidv5CLo2N4yENrdAAgHnmNS9IfgrqMPyNKLl0mVCLANmNlHzgzWRdoKagXSAEsDdTkL0WhUBPgvmcBxiBQBCKCwsfRcc8Sn58KRBC4CDlBmZuZkBpfrbQWV/P8Aoz6SC0WSvwAjNtOPaUdWQ/RRi5tVRH+tgloQofNrLS0cf0gW58JJze8Q9634nZ+0QohXx3qVQgYtC8PEFhpCzIUiCZ0IEOzrkhDvZ08vY5MLO4oTbp263RhqYxz2GtkqzRoFK+vjtlgsZ5+Npe8KIt2YJ/M3Pbr8X0Ry12z8U2U7gfNzs660tFvCAI6aVT48bWAqNAzVLKyb2FiuYGW3lH8rwUGxwfAK4UyKQYnm0Po6jfYI9nX8mdr17XA48EAg0EFNgJ/jCg8gGGphCgAAAABJRU5ErkJggg==",
            "Feature": "[-0.04595605,-0.0038912394,-0.012384229]",
            "LeftTopX": 600
        }
    },
    "Code": "Success",
    "Success": true
}

错误码

HttpCode 错误码 错误信息 描述
401 InvalidCorpIdError The specified CorpId is invalid. 无效的项目码

访问错误中心查看更多错误码。