[AI39-1] 外观防侵权检索-提交工作流任务

post
https://connect.zhihuiya.com/api/mcp/submit-workflow
在体验中心中试用

提交图片并创建异步检索任务。提交成功后使用 task_id 查询状态和阶段结果。支持 URL 或 Base64,两者至少一个非空,同时提供时优先 URL。参数校验失败不创建任务;其他提交失败不保证任务记录不存在。 输入示例(URL): ```json { "url": "https://example.com/product.png", "description": "目标产品描述", "lang": "cn", "country": [ "CN", "EU" ], "loc_items": [ { "id": "09-01", "desc": "瓶、长颈瓶、鼓形瓶" } ], "apply_start_time": "20200101", "apply_end_time": "20260917", "simple_legal_status": "1,2" } ``` 输入示例(Base64): ```json { "target_image_base64": "", "description": "目标产品描述", "lang": "cn", "country": [ "CN", "EU" ], "simple_legal_status": "1,2" } ``` 成功响应示例: ```json { "code": 0, "success": true, "task_id": "task_0123456789ab", "country": [ "CN", "EU" ], "message": "工作流任务已提交", "status": true } ``` 失败响应示例: ```json { "code": 1, "success": false, "task_id": null, "message": "提交工作流失败: 图片读取失败", "status": false } ``` 参数校验失败示例(HTTP 422): ```json { "detail": [ { "loc": [ "body", "country" ], "msg": "Input should be a valid list", "type": "list_type", "input": "EU" } ], "code": 1, "status": false, "success": false } ``` 示例中的任务 ID 和地址需替换;Base64 占位符需替换为实际图片数据。result_data 示例省略了业务内容。示例中的 message 为实际接口文本示意,不保证随 lang 翻译。

成功响应示例

成功调用 API 的响应示例

JSON
{
  "status": true,
  "message": "任务提交成功",
  "success": true,
  "task_id": "8f3c1b2a-9d4e-4a7b-bc5e-12345678abcd",
  "error_code": 0
}

错误码

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

业务错误码

错误码描述
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