调用本接口新增一个相似图样本图库。
使用说明
业务接口:/green/similarity/library/add
调用本接口新增样本图库后,您可以通过图库的维度管理样本图片。
使用限制
- 一个阿里云账号最多可以创建10个图库(包含系统默认图库)。
- 每个图库中的样本图片数量最多不超过10万张。
QPS限制
本接口的单用户QPS限制为10次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。
请求参数
关于公共请求参数,请参见公共参数。
请求body是一个JSON对象,字段说明如下。
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
name | String | 是 | xxxx | 要增加的图库的名称。同区域内的所有图库名称必须唯一。名称长度在64个字符以内,可以是中文、英文、下划线的组合。 |
返回数据
关于返回参数的说明,请参见返回结果。
返回body中的data字段是JSON数组,每一个元素包含如下字段。
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
code | Integer | 200 | 错误码,和HTTP状态码一致。
更多信息,请参见公共错误码。 |
msg | String | OK | 请求信息的响应消息。 |
name | String | xxxx | 图库名称。 |
createTime | Integer | 1614588092 | 创建图库的时间戳。 |
imageCount | Integer | 0 | 图库中的图片样本的数量。 |
region | String | cn-shanghai | 图库所属区域。 |
requestId | String | 33921869-CF8A-4E62-8C31-44F37341FFC1 | 本次请求的ID。 |
示例
请求示例
http(s)://[Endpoint]/green/similarity/library/add
&<公共请求参数>
{
"name": "xxxx"
}
返回示例
{
"msg": "OK",
"code": 200,
"requestId": "33921869-CF8A-4E62-8C31-44F37341FFC1",
"name": "xxxx",
"createTime":,
"imageCount":0,
"region":"cn-shanghai"
}