调用本接口新增一个相似图样本图库。

使用说明

业务接口:/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"
}