List assets
curl --request POST \
--url https://gengen.farm/api/gengen/v1/assets/list \
--header 'Authorization: Bearer gengen_live_xxxxxxxxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data '{
"Filter": {
"GroupIds": [
"group-20260424-abc"
],
"GroupType": "AIGC",
"Statuses": [
"Active"
]
},
"PageNumber": 1,
"PageSize": 10,
"SortBy": "CreateTime",
"SortOrder": "Desc"
}'import requests
url = "https://gengen.farm/api/gengen/v1/assets/list"
payload = {
"Filter": {
"GroupIds": ["group-20260424-abc"],
"GroupType": "AIGC",
"Statuses": ["Active"]
},
"PageNumber": 1,
"PageSize": 10
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
Filter: {GroupIds: ['group-20260424-abc'], GroupType: 'AIGC', Statuses: ['Active']},
PageNumber: 1,
PageSize: 10
})
};
fetch('https://gengen.farm/api/gengen/v1/assets/list', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"ResponseMetadata": {
"RequestId": "20260427000000000000000000000000",
"Action": "ListAssets",
"Version": "2024-01-01",
"Service": "ark",
"Region": "ap-southeast-1"
},
"Result": {
"Items": [
{
"Id": "asset-20260427-abc",
"Name": "portrait-front",
"URL": "https://example.com/temporary-asset-url",
"GroupId": "group-20260424-abc",
"AssetType": "Image",
"Status": "Active",
"ProjectName": "default",
"CreateTime": "2026-04-24T00:00:00Z",
"UpdateTime": "2026-04-24T00:00:00Z"
}
],
"TotalCount": 1,
"PageNumber": 1,
"PageSize": 10
}
}{
"error_code": "<string>",
"error": "<string>",
"error_params": {}
}{
"error_code": "<string>",
"error": "<string>",
"error_params": {}
}{
"error_code": "<string>",
"error": "<string>",
"error_params": {}
}{
"error_code": "<string>",
"error": "<string>",
"error_params": {}
}{
"error_code": "<string>",
"error": "<string>",
"error_params": {}
}{
"error_code": "<string>",
"error": "<string>",
"error_params": {}
}{
"error_code": "<string>",
"error": "<string>",
"error_params": {}
}{
"error_code": "<string>",
"error": "<string>",
"error_params": {}
}Assets API
List assets
List assets with filtering, sorting, and pagination; returned signed URLs expire after 12 hours.
POST
/
assets
/
list
List assets
curl --request POST \
--url https://gengen.farm/api/gengen/v1/assets/list \
--header 'Authorization: Bearer gengen_live_xxxxxxxxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data '{
"Filter": {
"GroupIds": [
"group-20260424-abc"
],
"GroupType": "AIGC",
"Statuses": [
"Active"
]
},
"PageNumber": 1,
"PageSize": 10,
"SortBy": "CreateTime",
"SortOrder": "Desc"
}'import requests
url = "https://gengen.farm/api/gengen/v1/assets/list"
payload = {
"Filter": {
"GroupIds": ["group-20260424-abc"],
"GroupType": "AIGC",
"Statuses": ["Active"]
},
"PageNumber": 1,
"PageSize": 10
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
Filter: {GroupIds: ['group-20260424-abc'], GroupType: 'AIGC', Statuses: ['Active']},
PageNumber: 1,
PageSize: 10
})
};
fetch('https://gengen.farm/api/gengen/v1/assets/list', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"ResponseMetadata": {
"RequestId": "20260427000000000000000000000000",
"Action": "ListAssets",
"Version": "2024-01-01",
"Service": "ark",
"Region": "ap-southeast-1"
},
"Result": {
"Items": [
{
"Id": "asset-20260427-abc",
"Name": "portrait-front",
"URL": "https://example.com/temporary-asset-url",
"GroupId": "group-20260424-abc",
"AssetType": "Image",
"Status": "Active",
"ProjectName": "default",
"CreateTime": "2026-04-24T00:00:00Z",
"UpdateTime": "2026-04-24T00:00:00Z"
}
],
"TotalCount": 1,
"PageNumber": 1,
"PageSize": 10
}
}{
"error_code": "<string>",
"error": "<string>",
"error_params": {}
}{
"error_code": "<string>",
"error": "<string>",
"error_params": {}
}{
"error_code": "<string>",
"error": "<string>",
"error_params": {}
}{
"error_code": "<string>",
"error": "<string>",
"error_params": {}
}{
"error_code": "<string>",
"error": "<string>",
"error_params": {}
}{
"error_code": "<string>",
"error": "<string>",
"error_params": {}
}{
"error_code": "<string>",
"error": "<string>",
"error_params": {}
}{
"error_code": "<string>",
"error": "<string>",
"error_params": {}
}Authorizations
A workspace API key beginning with gengen_live_.
Body
application/json
Show child attributes
Show child attributes
Required range:
x >= 1Required range:
1 <= x <= 100Supported sort fields:
- CreateTime — creation time
- UpdateTime — last update time
- GroupId — owning asset group ID
Available options:
CreateTime, UpdateTime, GroupId Supported sort orders:
- Asc — ascending
- Desc — descending
Available options:
Asc, Desc ⌘I