[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"

错误码

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

业务错误码

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

平台错误码

错误码描述
67200001API整体限流错误!
67200002用户调用请求限流限制错误!
67200003申请token的key和secret不正确或者状态错误!
67200004无权限或该接口的套餐已超过系统设置的上限!
67200005账户余额不足,调用失败!
67200006客户端已过期,调用失败!
67200007超过调用额度,调用失败!

HTTP 状态码

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

性能指标

此接口的预期性能特征

正常响应时间

5000 ms

最大响应时间

10000 ms