[AI39-1] 外观防侵权检索升级版-提交完整FTO工作流任务

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

提交目标图片并触发完整 FTO 工作流。url 与 target_image_base64 至少提供一个,同时提供时优先使用 url。task_id 由服务端自动生成,不接受外部传入。

请求参数

此 API 接口支持的参数列表

名称类型示例描述
user_id
stringuser_123456
用户ID,可选;不传时服务端会使用上下文用户或生成匿名 MCP 用户
url
stringhttps://example.com/target-image.jpg
目标图片URL;url 与 target_image_base64 至少传一个,同时传时优先使用 url
target_image_base64
stringiVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=
目标图片base64编码;url 与 target_image_base64 至少传一个,同时传时优先使用 url
title
stringFTO 图像检索任务-2026-05-22
任务标题
country
array[ "CN", "US", "EU" ]
国家/地区代码列表,如 CN、US、JP、KR、AU、EU
loc_items
array[ { "id": "09-01", "desc": "包装容器" } ]
LOC 分类项列表
id
必填
string09-01
LOC 分类号,如 09-01
desc
string包装容器
LOC 分类说明
apply_start_time
string20200101
申请开始时间,格式 YYYYMMDD
apply_end_time
string20260522
申请结束时间,格式 YYYYMMDD
simple_legal_status
string1,2
简单法律状态过滤,逗号分隔。0=失效,1=有效,2=审中。不传默认 1,2;如需包含失效专利传 0,1,2

响应结构

API 响应数据的结构说明

字段名类型示例描述
message
必填
string任务提交成功
提交结果消息
success
必填
booleantrue
是否提交成功
task_id
string8f3c1b2a-9d4e-4a7b-bc5e-12345678abcd
服务端自动生成的任务ID;提交失败时可能为空

成功响应示例

成功调用 API 的响应示例

JSON
{
  "status": true,
  "message": "任务提交成功",
  "success": true,
  "task_id": "8f3c1b2a-9d4e-4a7b-bc5e-12345678abcd",
  "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参数校验错误

性能指标

此接口的预期性能特征

正常响应时间

5000 ms

最大响应时间

10000 ms