POST {BaseUrl}/?Action=GetAsset&Version=2024-01-01
Content-Type: application/json
Status with this action. Once it is Active, the asset can be referenced in generation tasks.
Request parameters
string
required
Asset ID.
string
Pass
default or omit.Response parameters
object
Hide properties
Hide properties
string
Asset ID.
string
ID of the group the asset belongs to.
string
Asset name.
string
Asset type:
Image, Audio or Video.string
Processing status:
Processing, Active or Failed.string
Temporary access URL of the asset. It expires and must not be stored as a permanent address.
object
Failure reason with
Code and Message, returned when Status=Failed.object
Moderation strategy.
string
Time the asset was last referenced by a generation task. May be absent.
string
Project name.
string
Creation time, ISO 8601 UTC.
string
Last update time, ISO 8601 UTC.
{
"Id": "asset-20261020080000-abcde"
}
{
"ResponseMetadata": {
"RequestId": "20261020080000ABCDEF",
"Action": "GetAsset",
"Version": "2024-01-01",
"Service": "ark",
"Region": "ap-southeast-1"
},
"Result": {
"Id": "asset-20261020080000-abcde",
"GroupId": "group-20261020080000-abcde",
"Name": "tea-reference",
"AssetType": "Image",
"Status": "Active",
"URL": "https://media.example.com/reference.jpg?signature=xxx",
"Moderation": {
"Strategy": "Default"
},
"ProjectName": "default",
"CreateTime": "2026-10-20T08:00:00Z",
"UpdateTime": "2026-10-20T08:00:03Z"
}
}
{
"ResponseMetadata": {
"RequestId": "20261020080000ABCDEF",
"Action": "GetAsset",
"Version": "2024-01-01",
"Service": "ark",
"Region": "ap-southeast-1"
},
"Result": {
"Id": "asset-20261020080000-abcde",
"GroupId": "group-20261020080000-abcde",
"Name": "tea-reference",
"AssetType": "Image",
"Status": "Failed",
"Error": {
"Code": "InvalidParameter.DownloadFailed",
"Message": "Failed to download the file from the URL."
},
"ProjectName": "default",
"CreateTime": "2026-10-20T08:00:00Z",
"UpdateTime": "2026-10-20T08:00:05Z"
}
}