[AI39-3] 外观防侵权检索-获取阶段执行结果

get
https://connect.zhihuiya.com/api/mcp/task/stage/result
在体验中心中试用

获取指定阶段完整结果。最终报告使用 generate_report；报告完成且导出成功时返回可选的 data.report_export。顶层 status=true 不代表该阶段执行成功，请检查 data.stage_status。地区条件通过图搜向量预过滤传递，不能仅凭 search_request.q 缺少地区判断未过滤；0 条候选不等于无风险。 输入示例（参数通过 URL query 传递，无请求体）： ```http GET /api/mcp/task/stage/result?task_id=task_0123456789ab&stage=generate_report&image_mode=base64 ``` 成功响应示例： ```json { "code": 0, "success": true, "data": { "stage": "generate_report", "stage_status": "completed", "result_data": {}, "execution_duration": 10.5, "retry_count": 0, "error_message": null, "report_export": { "download_url": "https://example.com/report.docx?signature=example", "file_name": "mcp_design_fto_report_task_0123456789ab_cn_1789610400000.docx" } }, "status": true } ``` 失败响应示例： ```json { "code": 1, "success": false, "message": "Stage结果不存在: task_id=task_0123456789ab, stage=generate_report", "status": false } ``` 示例中的任务 ID 和地址需替换；Base64 占位符需替换为实际图片数据。result_data 示例省略了业务内容。示例中的 message 为实际接口文本示意，不保证随 lang 翻译。

请求参数

此 API 接口支持的参数列表

名称类型示例描述
task_id
必填
stringtask_0123456789ab
【必填】提交接口返回的任务 ID。 示例："task_0123456789ab"
stage
必填
stringgenerate_report
【必填】阶段名称：convert_lineart、image_search、rerank、generate_report。 示例："generate_report"
image_mode
stringbase64
【可选】报告导出图片模式，默认 base64。 示例："base64"

响应结构

API 响应数据的结构说明

字段名类型示例描述
code
必填
integer-
业务码：0 表示本次接口操作成功，1 表示失败。
data
object{ "stage": "generate_report", "result_data": {}, "retry_count": 0, "stage_status": "completed", "report_export": { "file_name": "mcp_design_fto_report_task_0123456789ab_cn_1789610400000.docx", "download_url": "https://example.com/report.docx?signature=example" }, "execution_duration": 10.5 }
阶段结果及可选的报告下载信息。
stage
必填
stringgenerate_report
阶段名称：convert_lineart、image_search、rerank 或 generate_report。
result_data
必填
object{}
该阶段的原始业务结果，结构随阶段变化；未完成或失败时可能为 null。示例空对象省略了业务内容。
retry_count
必填
integer-
阶段重试次数。
stage_status
必填
stringcompleted
阶段执行状态，应独立于接口 code/status 判断。
error_message
必填
string图像检索超时
任务或阶段错误说明；无错误时通常为 null。
report_export
object{ "file_name": "mcp_design_fto_report_task_0123456789ab_cn_1789610400000.docx", "download_url": "https://example.com/report.docx?signature=example" }
仅报告阶段完成且导出成功时提供；缺失不一定表示查询失败。
file_name
必填
stringmcp_design_fto_report_task_0123456789ab_cn_1789610400000.docx
导出的 Word 报告文件名。
download_url
必填
stringhttps://example.com/report.docx?signature=example
Word 报告的临时签名下载地址。
execution_duration
必填
number10.5
阶段执行耗时，单位秒，可能为 null。
status
必填
booleantrue
本次接口操作是否成功，不代表异步任务已完成。
message
string提交工作流失败: 图片读取失败
接口操作说明；失败时说明原因。
success
必填
booleantrue
保留的接口操作成功标记，与顶层 status 一致。
task_id
stringtask_0123456789ab
任务 ID，用于查询进度和阶段结果。提交失败时可能为 null，不保证数据库中不存在任务记录。

成功响应示例

成功调用 API 的响应示例

JSON 
{
  "code": 0,
  "data": {
    "stage": "generate_report",
    "result_data": {},
    "retry_count": 0,
    "stage_status": "completed",
    "error_message": "图像检索超时",
    "report_export": {
      "file_name": "mcp_design_fto_report_task_0123456789ab_cn_1789610400000.docx",
      "download_url": "https://example.com/report.docx?signature=example"
    },
    "execution_duration": 10.5
  },
  "status": true,
  "message": "提交工作流失败: 图片读取失败",
  "success": true,
  "task_id": "task_0123456789ab",
  "error_code": 0
}

错误码

此接口可能返回的错误码列表

业务错误码

错误码描述
68300004请求参数异常!
68300005查询Api失败!
68300006解析基本存取错误!
68300007存在错误的请求!
68300008服务中断异常，请稍后再试!
68300010文件不符合上传规范!

平台错误码

错误码描述
67200000API整体限流错误!
67200001API整体限流错误！
67200002当前调用速率过快,超过当前配置限制QPS！
67200003申请token的key和secret传参不正确或者客户端已被禁用！
67200004请求的接口无权限请联系我们的支持人员！
67200005账户余额/调用次数不足！
67200006客户端超过开通有效期！
67200007当前调用超过当天配置使用额度！
67200008请检查query参数中必填的apikey是否传输！
67200009apikey与所传的bearerToken不匹配,请检查是否使用在有效期内的token！
67200012请求不合法！
67200100当前服务器状态正忙,请求响应超时！
67200101当前请求的Api不存在请检查请求Path！

HTTP 状态码

状态码描述
0请求成功
422参数校验失败：status=false、code=1，并保留 detail。

性能指标

此接口的预期性能特征

正常响应时间

5000 ms

最大响应时间

10000 ms