[AI39-2] 外观防侵权检索-查询工作流任务状态
查询任务整体状态和各阶段摘要，用于轮询。顶层 status=true 仅表示查询成功；任务是否执行成功应读取 task.workflow_status。task.country 是保存的提交地区条件。 输入示例（参数通过 URL query 传递，无请求体）： ```http GET /api/mcp/task/status?task_id=task_0123456789ab ``` 成功响应示例： ```json { "code": 0, "success": true, "task": { "task_id": "task_0123456789ab", "workflow_status": "running", "current_stage": "rerank", "current_stage_order": 3, "title": "产品外观检索", "country": [ "CN", "EU" ], "total_execution_duration": null, "error_message": null, "created_at": "2026-09-17 02:00:00+00:00" }, "stages": [ { "stage": "convert_lineart", "stage_order": 1, "status": "completed", "execution_duration": 12.3, "retry_count": 0, "error_message": null }, { "stage": "image_search", "stage_order": 2, "status": "completed", "execution_duration": 8.5, "retry_count": 0, "error_message": null }, { "stage": "rerank", "stage_order": 3, "status": "running", "execution_duration": null, "retry_count": 0, "error_message": null }, { "stage": "generate_report", "stage_order": 4, "status": "pending", "execution_duration": null, "retry_count": 0, "error_message": null } ], "status": true } ``` 失败响应示例： ```json { "code": 1, "success": false, "message": "任务不存在: task_0123456789ab", "status": false } ``` 示例中的任务 ID 和地址需替换；Base64 占位符需替换为实际图片数据。result_data 示例省略了业务内容。示例中的 message 为实际接口文本示意，不保证随 lang 翻译。
请求参数
此 API 接口支持的参数列表
| 名称 | 类型 | 示例 | 描述 |
|---|---|---|---|
必填 | string | task_0123456789ab | 【必填】提交接口返回的任务 ID。 示例："task_0123456789ab" |
响应结构
API 响应数据的结构说明
| 字段名 | 类型 | 示例 | 描述 |
|---|---|---|---|
code必填 | integer | - | 业务码：0 表示本次接口操作成功，1 表示失败。 |
task | object | {
"title": "产品外观检索",
"country": [
"CN",
"EU"
],
"task_id": "task_0123456789ab",
"created_at": "2026-09-17 02:00:00+00:00",
"current_stage": "rerank",
"workflow_status": "running",
"current_stage_order": 3
} | 任务基本信息和整体执行状态。 |
title必填 | string | 产品外观检索 | 任务名称，仅为返回字段。 |
country必填 | array | [
"CN",
"EU"
] | 保存或归一化后的提交地区条件，不代表已完成检索。 |
task_id必填 | string | task_0123456789ab | 任务 ID，用于查询进度和阶段结果。提交失败时可能为 null，不保证数据库中不存在任务记录。 |
created_at必填 | string | 2026-09-17 02:00:00+00:00 | 任务创建时间，包含时区。 |
current_stage必填 | string | rerank | 当前执行阶段。 |
error_message必填 | string | 图像检索超时 | 任务或阶段错误说明；无错误时通常为 null。 |
workflow_status必填 | string | running | 任务状态：pending、running、completed、failed、cancelled、paused，以实际返回为准。 |
current_stage_order必填 | integer | 3 | 当前阶段序号。 |
total_execution_duration必填 | number | 39.3 | 任务总执行耗时，单位秒，可能为 null。 |
stages | array | [
{
"stage": "convert_lineart",
"status": "completed",
"retry_count": 0,
"stage_order": 1,
"execution_duration": 12.3
},
{
"stage": "image_search",
"status": "completed",
"retry_count": 0,
"stage_order": 2,
"execution_duration": 8.5
},
{
"stage": "rerank",
"status": "running",
"retry_count": 0,
"stage_order": 3
},
{
"stage": "generate_report",
"status": "pending",
"retry_count": 0,
"stage_order": 4
}
] | 按 stage_order 排序的阶段摘要，不包含完整 result_data。 |
stage必填 | string | convert_lineart | 阶段名称：convert_lineart、image_search、rerank 或 generate_report。 |
status必填 | string | completed | 阶段状态字符串，如 pending、running、completed、failed、retrying；不是顶层布尔 status。 |
retry_count必填 | integer | - | 阶段重试次数。 |
stage_order必填 | integer | 1 | 阶段执行顺序。 |
error_message必填 | string | 图像检索超时 | 任务或阶段错误说明；无错误时通常为 null。 |
execution_duration必填 | number | 12.3 | 阶段执行耗时，单位秒，可能为 null。 |
status必填 | boolean | true | 本次接口操作是否成功，不代表异步任务已完成。 |
message | string | 提交工作流失败: 图片读取失败 | 接口操作说明；失败时说明原因。 |
success必填 | boolean | true | 保留的接口操作成功标记，与顶层 status 一致。 |
task_id | string | task_0123456789ab | 任务 ID，用于查询进度和阶段结果。提交失败时可能为 null，不保证数据库中不存在任务记录。 |
成功响应示例
成功调用 API 的响应示例
{
"code": 0,
"task": {
"title": "产品外观检索",
"country": [
"CN",
"EU"
],
"task_id": "task_0123456789ab",
"created_at": "2026-09-17 02:00:00+00:00",
"current_stage": "rerank",
"error_message": "图像检索超时",
"workflow_status": "running",
"current_stage_order": 3,
"total_execution_duration": 39.3
},
"stages": [
{
"stage": "convert_lineart",
"status": "completed",
"retry_count": 0,
"stage_order": 1,
"error_message": "图像检索超时",
"execution_duration": 12.3
}
],
"status": true,
"message": "提交工作流失败: 图片读取失败",
"success": true,
"task_id": "task_0123456789ab",
"error_code": 0
}错误码
此接口可能返回的错误码列表
业务错误码
| 错误码 | 描述 |
|---|---|
68300004 | 请求参数异常! |
68300005 | 查询Api失败! |
68300006 | 解析基本存取错误! |
68300007 | 存在错误的请求! |
68300008 | 服务中断异常，请稍后再试! |
68300010 | 文件不符合上传规范! |
平台错误码
| 错误码 | 描述 |
|---|---|
67200000 | API整体限流错误! |
67200001 | API整体限流错误！ |
67200002 | 当前调用速率过快,超过当前配置限制QPS！ |
67200003 | 申请token的key和secret传参不正确或者客户端已被禁用！ |
67200004 | 请求的接口无权限请联系我们的支持人员！ |
67200005 | 账户余额/调用次数不足！ |
67200006 | 客户端超过开通有效期！ |
67200007 | 当前调用超过当天配置使用额度！ |
67200008 | 请检查query参数中必填的apikey是否传输！ |
67200009 | apikey与所传的bearerToken不匹配,请检查是否使用在有效期内的token！ |
67200012 | 请求不合法！ |
67200100 | 当前服务器状态正忙,请求响应超时！ |
67200101 | 当前请求的Api不存在请检查请求Path！ |
HTTP 状态码
| 状态码 | 描述 |
|---|---|
0 | 请求成功 |
422 | 参数校验失败：status=false、code=1，并保留 detail。 |
性能指标
此接口的预期性能特征
正常响应时间
5000 ms
最大响应时间
10000 ms