List assets
List assets owned by the current user with filtering by group, name, and status.
Authorization
BearerAuth API key authentication (OpenAI format). Pass in the Authorization header:
Authorization: Bearer tr-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
In: header
Query Parameters
Page number, starting from 1
11 <= valueItems per page, maximum 100
101 <= value <= 100Filter by group ID (must be a group owned by the current user)
Group type, required by upstream Volcengine Ark. aigc (default) lists AIGC asset groups; real_person lists liveness (LivenessFace) groups created via the validate-session flow. You must pass the matching type even when group_id is set: to list a real-person group's assets, pass type=real_person, otherwise the default aigc filter returns an empty list. Upstream accepts only a single type; there is no "return all" option.
"aigc""aigc" | "real_person"Filter by asset name (fuzzy match)
Filter by status: Active, Processing, Failed
"Active" | "Processing" | "Failed"Response Body
application/json
application/json
application/json
application/json
curl -X get "https://api.xrtoken.ai/v1/assets"{
"Items": [
{
"Id": "string",
"Name": "string",
"AssetType": "Image",
"Status": "Active",
"GroupId": "string",
"URL": "string",
"CreateTime": "string",
"UpdateTime": "string",
"Error": {
"Code": "string",
"Message": "string"
}
}
],
"TotalCount": 0,
"PageNumber": 0,
"PageSize": 0
}{
"error": "invalid or missing API key",
"type": "auth_error"
}{
"error": "string",
"type": "invalid_request_error"
}{
"error": "rate limit exceeded",
"type": "rate_limit_error"
}