综合识别图片中的常见实物,包含美食、家装家居、动植物、地标、交通工具等类别的数千种实体。
名称 | 内容 |
---|---|
图片要求 | 1. 图片格式:JPG、JPEG、PNG、BMP等常见格式,建议使用JPG格式。 |
名称 | 内容 |
---|---|
接口地址 | https://visual.volcengineapi.com |
请求方式 | POST |
Content-Type | application/x-www-form-urlencoded |
请求参数
(1)header请求参数
公共请求参数
以下请求参数列表仅列出了接口请求参数和必要公共参数,完整公共参数列表见 公共参数
名称 | 类型 | 是否必填 | 描述 |
---|---|---|---|
X-Date | String | 是 | 使用UTC时间,精确到秒。请使用格式:YYYYMMDD'T'HHMMSS'Z' ,例如:20201103T104027Z |
Authorization | String | 是 | HMAC-SHA256:签名方法 |
X-Security-Token | String | 否 | 指安全令牌服务(Security Token Service,STS) 颁发的临时安全凭证中的SessionToken,使用长期密钥时无需填写该参数。 |
(2)Query参数
业务请求参数
参数 | 可选/必选 | 类型 | 说明 |
---|---|---|---|
Action | 必选 | String | 接口名,取值:EntityDetect |
Version | 必选 | String | 版本号,取值:2020-08-26 |
(3)Body参数
业务请求参数
参数 | 可选/必选 | 类型 | 说明 |
---|---|---|---|
image_base64 | 必选(二选一,优先生效) | String | 图片Base64编码 |
image_url | 必选(二选一) | String | 图片文件URL |
(1)通用输出参数
请参考通用返回字段及错误码
(2)业务输出参数
data 字段说明
字段 | 类型 | 说明 |
---|---|---|
entities | String | 识别识别结果 |
(3)输出示例
{ "status": 10000, "code": 10000, "time_elapsed": "1.49221491814s", "request_id": "68929651727767982161604893518", "message": "Success", "data": { "entities": [ "猫", "勺子" ] } }
(1)通用错误码
请参考通用返回字段及错误码
(2)业务错误码
HttpCode | 错误码 | 错误消息 | 描述 |
---|---|---|---|
200 | 10000 | 无 | 请求成功 |