All Products
Search
Document Center

AI Guardrails:UploadImageToLib

Last Updated:Mar 31, 2026

Uploads images to a specified image library.

Operation description

Operation: UploadImageToLib

For information about how to construct an HTTP request, see Request syntax. You can also use an existing SDK. For more information, see SDK overview.

Billing: This operation is free of charge.

QPS limit

This operation supports up to 10 calls per second per account. Exceeding this limit triggers throttling, which may affect your business.

Request parameters

ParameterTypeRequiredExampleDescription
ImageLibIdIntegerYes2147The primary key ID of the image library.
UrlsListYes["http://example.com/1.jpg"]The image URLs. Each element in the list is the access URL of an Object Storage Service (OSS) bucket object. The URL can be up to 2,048 characters in length.

Response elements

ParameterTypeExampleDescription
RequestIdString795D8871-4889-4C0F-A8B1-C7D2B990FF61The request ID.

Examples

Sample request

http(s)://green.cn-shanghai.aliyuncs.com/?Action=UploadImageToLib&ServiceModule=open_api
&<Common request parameters>
{
    "ImageLibId": 2147,
    "Urls": "[\"http://example.com/1.jpg\"]"
}

Sample response

{
    "RequestId": "795D8871-4889-4C0F-A8B1-C7D2B990FF61",
    "code": 200
}