查询batch任务状态
GET
https://video.unboundtech.cn/api/batch/batch_get_status
查询 Batch 任务状态
请求参数
| 参数名 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
batch_id | Query | string | 是 | 批量任务的唯一标识符（UUID 格式） |
示例： batch_id=e828c40f-7582-4476-9281-51e22eab73be
认证方式
AuthorizationBearer <API_KEY>🔒 注：API Key 需通过服务商申请，具有访问权限控制。
响应说明
成功响应（HTTP 200）
{
"batch_id": "e828c40f-7582-4476-9281-51e22eab73be",
"total": 6674,
"pending": 3103,
"processing": 0,
"completed": 3382,
"failed": 189
}字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
batch_id | string | 任务 ID |
status | string | 任务状态，取值： • pending（排队中）• processing（处理中）• completed（已完成）• failed（失败） |
created_at | string | 任务创建时间（ISO 8601） |
updated_at | string | 任务最后更新时间 |
total_count | integer | 总数据条数 |
processed_count | integer | 已处理条数 |
failed_count | integer | 处理失败条数 |
result_available | boolean | 结果是否可拉取（仅当 status=completed 时为 true） |
错误响应示例
400 Bad Request（参数缺失）
{
"code": 400,
"message": "Missing required parameter: batch_id"
}401 Unauthorized（认证失败）
{
"code": 401,
"message": "Invalid or missing Authorization token"
}404 Not Found（任务不存在）
{
"code": 404,
"message": "Batch task not found"
}使用建议
1.
2.
status 为 completed 且 result_available 为 true 时，请及时调用 取回batch任务结果3.
processing 状态（如超过 24 小时），请联系技术支持。注意事项
请求参数
Query 参数
Header 参数
请求示例代码
返回响应
修改于 2026-01-29 14:29:12