Overview
This API is used to retrieve the metadata of a specified batch file. Currently, this API is supported only by Alibaba Cloud's Qwen series of models.
API details
Constraints
- You must have an API key. For more information, see Manage AI API keys.
Request path
GET {BASE_URL}/api/v1/files/{file_id}
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 |
|---|---|---|---|---|
| file_id | string | Yes | None |
Query
None
Body
None
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/files/{file_id}' \
--header 'Authorization: Bearer {token}'
Response example
{
"success": true,
"code": "200",
"message": "successful",
"data": {
"id": "r-123456",
"name": "demo-name",
"status": "RUNNING",
"createTime": "2026-04-10T10:00:00Z"
}
}