[AI66-1]防侵权检索-创建任务

post
https://stage-connect.zhihuiya.com/fto_steps/create_task
在体验中心中试用

创建/触发 FTO 任务：生成或复用 task_id，落库技术方案及检索过滤条件（country/legal_status/include_company/exclude_company/apd_start/apd_end/input_lang/image_file_keys）。纯同步的数据库写入，不经过后台任务与轮询，不触发任何流程步骤，也不占用步骤锁；返回时落库已完成。后续步骤（proposal_refine、feature_extraction 等）同一 task_id 可省略 technical_proposal，自动回读这里落库的方案。

请求参数

此 API 接口支持的参数列表

名称类型示例描述
task_id
stringfto-20260928-a1b2c3d4
任务ID（可选），不传则自动生成 fto-{yyyymmdd}-{8位hex}。
tech_description
必填
string一种基于机器学习的图像识别系统，能够自动识别产品缺陷
技术方案描述文本，必填。落库为 technical_proposal，供后续步骤按 task_id 自动回读。
country
array[ "CN" ]
受理局过滤，不传表示不设置该过滤条件。
legal_status
array[ 1, 2 ]
简单法律状态列表（用于SO查询过滤，可选值：1=有效, 2=审中, 3=失效等）。
include_company
array[ "华为技术有限公司" ]
仅包含企业列表（申请人/专利权人白名单）。
exclude_company
array[ "某公司A" ]
排除企业列表（申请人/专利权人黑名单）。
apd_start
string2020-01-01
起始时间（申请日/公开日过滤，格式：YYYY-MM-DD）。
apd_end
string2023-12-31
截止时间（申请日/公开日过滤，格式：YYYY-MM-DD）。
input_lang
stringcn
输入语言：cn / en / tw / jp。本步骤当前未使用该字段（保留字段，可忽略）。
image_file_keys
array[ "file_key_1", "file_key_2" ]
图片文件key列表，供 proposal_refine 步骤的方案润色使用。

响应结构

API 响应数据的结构说明

字段名类型示例描述
status
必填
stringcreated
固定为 created，表示落库已完成（同步操作，无 running 中间态）。
task_id
必填
stringfto-20260928-a1b2c3d4
任务 ID（新生成或复用调用方传入的值）。

成功响应示例

成功调用 API 的响应示例

JSON 
{
  "status": true,
  "task_id": "fto-20260928-a1b2c3d4",
  "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请求成功
422Validation Error
500落库失败

性能指标

此接口的预期性能特征

正常响应时间

5000 ms

最大响应时间

10000 ms