[AI39-1] 外观防侵权检索升级版-提交完整FTO工作流任务
提交目标图片并触发完整 FTO 工作流。url 与 target_image_base64 至少提供一个,同时提供时优先使用 url。task_id 由服务端自动生成,不接受外部传入。
请求参数
此 API 接口支持的参数列表
| 名称 | 类型 | 示例 | 描述 |
|---|---|---|---|
| string | user_123456 | 用户ID,可选;不传时服务端会使用上下文用户或生成匿名 MCP 用户 |
| string | https://example.com/target-image.jpg | 目标图片URL;url 与 target_image_base64 至少传一个,同时传时优先使用 url |
| string | iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII= | 目标图片base64编码;url 与 target_image_base64 至少传一个,同时传时优先使用 url |
| string | FTO 图像检索任务-2026-05-22 | 任务标题 |
| array | [
"CN",
"US",
"EU"
] | 国家/地区代码列表,如 CN、US、JP、KR、AU、EU |
| array | [
{
"id": "09-01",
"desc": "包装容器"
}
] | LOC 分类项列表 |
必填 | string | 09-01 | LOC 分类号,如 09-01 |
| string | 包装容器 | LOC 分类说明 |
| string | 20200101 | 申请开始时间,格式 YYYYMMDD |
| string | 20260522 | 申请结束时间,格式 YYYYMMDD |
| string | 1,2 | 简单法律状态过滤,逗号分隔。0=失效,1=有效,2=审中。不传默认 1,2;如需包含失效专利传 0,1,2 |
响应结构
API 响应数据的结构说明
| 字段名 | 类型 | 示例 | 描述 |
|---|---|---|---|
message必填 | string | 任务提交成功 | 提交结果消息 |
success必填 | boolean | true | 是否提交成功 |
task_id | string | 8f3c1b2a-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 | 文件不符合上传规范! |
平台错误码
| 错误码 | 描述 |
|---|---|
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 | 参数校验错误 |
性能指标
此接口的预期性能特征
正常响应时间
5000 ms
最大响应时间
10000 ms