Overview
This API is used to return the list of batch tasks under the current project. Currently, this API is supported only by Alibaba Cloud's Qwen series of models.
API details
Constraints
- The caller must have an API Key. For more information, see Manage AI API Keys.
Request path
GET {BASE_URL}/api/v1/batches
Request header
Name |
Required |
Example value |
Description |
|---|---|---|---|
| Authorization | Yes | Bearer {token} | Authentication information |
| Content-Type | No | application/json | Request body format |
Request parameters
Path
Name |
Type |
Required |
Example value |
Description |
|---|---|---|---|---|
| resourceId | string | Yes | r-123456 | Resource ID |
Query
Name |
Type |
Required |
Example value |
Description |
|---|---|---|---|---|
| after | string | No | None | |
| limit | integer | No | None |
Body
Name |
Type |
Required |
Example value |
Description |
|---|---|---|---|---|
| name | string | Yes | demo-name | Resource name |
| description | string | No | demo description | Resource description |
Response
Response parameters
Name |
Type |
Description |
|---|---|---|
| success | boolean | Whether the request was successful |
| code | string | Response code |
| message | string | Response information |
| data | object | Business response data |
data
Name |
Type |
Description |
|---|---|---|
| id | string | Unique ID of the resource |
| name | string | Resource name |
| status | string | Resource status |
| createTime | string | Creation time |
Request example
curl --request GET '{BASE_URL}/api/v1/batches' \
--header 'Authorization: Bearer {token}' \
--header 'Content-Type: application/json' \
--data '{
"name": "demo-name",
"description": "demo description"
}'
Response example
{
"success": true,
"code": "200",
"message": "successful",
"data": {
"id": "r-123456",
"name": "demo-name",
"status": "RUNNING",
"createTime": "2026-04-10T10:00:00Z"
}
}