Query the details of a sample image-AI Guardrails(AI Guardrails)-阿里云帮助中心

Call this operation to query the details of a sample image in a specified image library.

Usage notes

Operation: /green/similarity/image/get

You can call this operation to query the details of a sample image in a specified image library.For more information about how to structure an HTTP request, see Request structure. You can also use a pre-built HTTP request. For more information, see SDK overview.

QPS limits

You can call this operation up to 20 times per second per account. If the number of calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation.

Request parameters

For more information about common request parameters, see Common parameters.

The request body is a JSON object. The following table describes the fields in the object.

Name	Type	Required	Example	Description
library	String	No	xxxx	The name of the image library to query. If you do not specify this parameter, the default image library is queried. The name of the default image library is default.
dataId	String	No	aaa	The ID of the sample image to query. Note Specify either the dataId or url parameter.
url	String	No	http://example.com/x.jpg	The URL of the sample image to query. Note Specify either the dataId or url parameter.

Response data

For more information about response parameters, see Response parameters.

The data field in the response body is a JSON array. Each element contains the following fields:

Name	Type	Example	Description
code	Integer	200	The returned HTTP status code. For more information, see Common error codes.
msg	String	OK	The message returned for the request.
dataId	String	aaa	The unique ID of the image.
url	String	http://example.com/x.jpg	The URL of the image.
createTime	Integer	xxx	The timestamp when the sample image was created in the image library.
tags	String	xxx	The tags of the sample image.
requestId	String	33921869-CF8A-4E62-8C31-44F37341FFC1	The ID of the request.

Examples

Request example

http(s)://[Endpoint]/green/similarity/image/get
&<Common request parameters>
{
  "library": "xxxx",
  "dataId": "aaa"
}

Response example

{
  "msg": "OK", 
  "code": 200, 
  "requestId": "33921869-CF8A-4E62-8C31-44F37341FFC1",
  "data":{
    "dataId": "aaa",
    "createTime":,
    "url" :"http:/example.com/x.jpg"
  }

}