Retrieve batch (POST) - 查询 Batch 任务

更新时间：2026-06-07 16:36:14

功能说明

此接口用于查询指定的 Batch 任务信息。其行为与 GET 方法一致，主要用于兼容部分调用方使用 POST 方法查询任务的需求。当前仅支持阿里云 qwen 系列模型。

调用说明

接口约束

调用者需要拥有 API Key，详情请参见管理 AI API Key。

请求路径

POST {BASE_URL}/api/v1/batches/{batch_id}

请求头

名称	是否必选	示例值	描述
Authorization	是	Bearer {token}	鉴权信息
Content-Type	否	application/json	请求体格式

请求参数

Path 参数

名称	类型	是否必填	示例值	描述
batch_id	string	是		Batch 任务 ID

Query 参数

无

Body 参数

无

返回结果

返回参数

名称	类型	描述
success	boolean	请求是否成功
code	string	返回码
message	string	返回信息
data	object	业务返回数据

data 字段说明

名称	类型	描述
id	string	资源唯一 ID
name	string	资源名称
status	string	资源状态
createTime	string	创建时间

请求示例

curl --request POST '{BASE_URL}/api/v1/batches/{batch_id}' \
  --header 'Authorization: Bearer {token}'

返回示例

{
  "success": true,
  "code": "200",
  "message": "successful",
  "data": {
    "id": "r-123456",
    "name": "demo-name",
    "status": "RUNNING",
    "createTime": "2026-04-10T10:00:00Z"
  }
}