[AI39-2]外观防侵权检索-获取结果
根据[AI39-1]提交任务接口返回的task_id,轮询获取外观专利检索任务的执行结果。返回内容包括:任务状态、线稿图(Base64)、传统图像搜索结果、RRF融合搜索结果和完整的分析报告。
注意:
1. 需要使用[AI39-1]接口返回的有效task_id
2. task_status状态说明:1-执行中、2-执行成功、3-执行失败
3. 建议轮询间隔为2-5秒
4. 当task_status为2时,返回完整的检索结果和分析报告
1. 需要使用[AI39-1]接口返回的有效task_id
2. task_status状态说明:1-执行中、2-执行成功、3-执行失败
3. 建议轮询间隔为2-5秒
4. 当task_status为2时,返回完整的检索结果和分析报告
请求参数
此 API 接口支持的参数列表
| 名称 | 类型 | 示例 | 描述 |
|---|---|---|---|
必填 | string | 80d440b7-80a5-4233-a75f-ab72b0885c88 | 任务唯一标识符,由提交任务接口返回 |
响应结构
API 响应数据的结构说明
| 字段名 | 类型 | 示例 | 描述 |
|---|---|---|---|
data | object | - | 响应数据 |
report | object | {
"loc": [
"21-01"
],
"country": [
"US",
"CN"
],
"comparisons": [
{
"score": 0.85,
"title": "Inflatable Santa",
"patent_id": "3fad2c19-8d3d-4f72-b5ae-f2de96787bc0",
"patent_pn": "USD1055174S1",
"risk_level": "High"
}
],
"high_risk_country": [
"US"
],
"middle_risk_country": [
"CN"
]
} | 外观专利图片搜索报告V2,包含专利对比分析、风险评估和出口建议 |
loc | array | [
"02 服装、服饰用品和缝纫用品",
"03 其他类未列入的旅行用品、箱包、阳伞和个人用品",
"10 钟、表及其他测量仪器,检测仪器,信号仪器",
"11 装饰品",
"19 文具、办公用品、美术用品和教学用品",
"21 游戏器具、玩具、帐篷和体育用品",
"32 图形符号、标识、表面图案、纹饰"
] | LOC分类号列表,标识产品的外观设计分类 |
country必填 | array | [
"US",
"CN",
"JP",
"KR",
"AU",
"EU"
] | 出口目标国家列表,使用国家代码表示 |
comparisons必填 | array | [
{
"score": 0.45,
"title": "人形",
"img_id": "0001747893000002",
"status": 1,
"country": "JP",
"similar": "主体均为圆柱形结构",
"confusion": "基础形状相似但设计元素差异足以区分",
"patent_id": "09115a22-cf5a-41e1-8e77-11a8fbb3a5b6",
"patent_pn": "JP1747893S",
"risk_desc": "JP标准关注核心要部",
"difference": "专利图顶部为复杂的结状结构",
"risk_level": "Low",
"suggestion": "保持当前帽子与垂耳的独特组合"
}
] | 与现有专利的对比项列表,包含相似度分析、风险评估和建议 |
score必填 | number<double> | 0.45 | 相似度分数,范围0-1,分数越高表示相似度越高 |
title必填 | string | 人形 | 专利标题 |
img_id必填 | string | 0001747893000002 | 专利图像标识符 |
status必填 | integer<int32> | 1 | 专利法律状态:1-有效,2-失效,3-待审 |
country必填 | string | JP | 专利授权国家代码 |
similar必填 | string | 主体均为圆柱形结构,且在圆柱面上分布有面部特征。 | 用户产品与专利的相似之处描述 |
confusion必填 | string | 虽然基础形状相似,但具体设计元素差异足以区分。 | 消费者可能混淆的原因分析 |
patent_id必填 | string | 09115a22-cf5a-41e1-8e77-11a8fbb3a5b6 | 专利唯一标识符 |
patent_pn必填 | string | JP1747893S | 专利公开号 |
risk_desc必填 | string | JP标准关注核心要部。尽管基础几何体(圆柱)相似,但头部装饰(帽子 vs 结)和附属件(垂耳 vs 线臂)的差异属于实质性区别。 | 风险描述,详细说明该专利对产品出口的潜在风险 |
difference必填 | string | 专利图顶部为复杂的结状/把手结构,两侧为线状手臂,面部特征为传统风格;用户图顶部为圆锥形帽子,两侧为宽扁垂耳,面部有突出的吻部造型。 | 用户产品与专利的差异之处描述 |
risk_level必填 | string | Low | 风险等级:High(高风险)、Medium(中风险)、Low(低风险) |
suggestion必填 | string | 保持当前帽子与垂耳的独特组合,以区别于通用的圆柱形玩偶。 | 规避侵权的建议措施 |
operate_date | integer<int64> | 1768195176553 | 操作时间戳(毫秒) |
apply_start_time | string | 20200101 | 专利申请起始时间,格式为yyyyMMdd |
high_risk_country | array | [
"KR"
] | 高风险出口国家列表,这些国家存在高度相似的专利 |
middle_risk_country | array | [
"KR"
] | 中风险出口国家列表,这些国家存在中度相似的专利 |
suspected_infringement_count | integer<int32> | - | 疑似侵权专利数量统计 |
suspected_infringement_country | array | [
"KR"
] | 疑似侵权国家列表,这些国家存在可能侵权的专利 |
task_id必填 | string | a1b2c3d4-e5f6-7890-abcd-ef1234567890 | 任务唯一标识符 |
task_status必填 | integer<int32> | 2 | 执行状态(1:执行中 2:执行成功 3:执行失败) |
patent_messages | object | {
"patent_messages": [
{
"score": 0.875770605053453,
"title": "Inflatable Santa",
"patent_id": "3fad2c19-8d3d-4f72-b5ae-f2de96787bc0",
"patent_pn": "USD1055174S1"
}
],
"total_search_result_count": 200
} | 传统图像搜索的专利结果数据 |
patent_messages必填 | array | [
{
"loc": [
"21-01"
],
"apno": "US29/961259",
"score": 0.875770605053453,
"title": "Inflatable Santa",
"img_id": "USD1055174-D00000_ABST",
"authority": "US",
"loc_match": 1,
"patent_id": "3fad2c19-8d3d-4f72-b5ae-f2de96787bc0",
"patent_pn": "USD1055174S1",
"risk_level": "High"
}
] | 专利信息列表,包含与用户图像相似的专利详细信息 |
loc | array | [
"21-01"
] | LOC分类号列表,标识专利的外观设计分类 |
url | string | https://example.com/patent/images/full/0001747893000002.jpg | 专利图像完整URL地址 |
apdt | integer<int32> | 20200115 | 专利申请日期,格式为yyyyMMdd的整数 |
apno | string | US29/961259 | 专利申请号 |
pbdt | integer<int32> | 20210320 | 专利公开日期,格式为yyyyMMdd的整数 |
score必填 | number<double> | 0.875770605053453 | 相似度分数,范围0-1,分数越高表示与用户图像越相似 |
title必填 | string | Inflatable Santa | 专利标题 |
img_id必填 | string | USD1055174-D00000_ABST | 专利图像标识符,用于获取专利图片 |
url_120 | string | https://example.com/patent/images/thumb/0001747893000002_120.jpg | 专利图像缩略图URL地址(120px) |
inventor | string | 张三;李四 | 发明人姓名,多个发明人用分号分隔 |
authority必填 | string | US | 受理局/国家代码,表示专利授权的国家或地区 |
loc_match | integer<int32> | 1 | LOC分类匹配标识:1-匹配,0-不匹配 |
patent_id必填 | string | 3fad2c19-8d3d-4f72-b5ae-f2de96787bc0 | 专利唯一标识符 |
patent_pn必填 | string | USD1055174S1 | 专利公开号 |
risk_level | string | High | 风险等级:High(高风险)、Medium(中风险)、Low(低风险) |
current_assignee | string | 某某科技有限公司 | 当前申请人/受让人名称 |
original_assignee | string | 某某科技有限公司 | 原始申请人/受让人名称 |
total_search_result_count必填 | integer<int32> | 156 | 搜索结果总数量,包括所有相似专利的数量 |
rrffusion_response | object | {
"k_value": 60,
"rerank_count": 200,
"patent_messages": [
{
"patent_id": "3fad2c19-8d3d-4f72-b5ae-f2de96787bc0",
"patent_pn": "USD1055174S1",
"rrf_score": 0.030158730158730156,
"rerank_rank": 10,
"rerank_score": 55,
"traditional_rank": 3
}
],
"traditional_count": 200
} | RRF融合搜索响应,综合传统搜索和AI重排序的结果 |
k_value必填 | integer<int32> | 60 | RRF融合算法的k参数值,用于调整融合权重 |
rerank_count必填 | integer<int32> | 200 | AI重排序返回的结果数量 |
patent_messages必填 | array | [
{
"loc": [
"21-01"
],
"apno": "US29/961259",
"score": 0.875770605053453,
"title": "Inflatable Santa",
"img_id": "USD1055174-D00000_ABST",
"loc_match": 1,
"patent_id": "3fad2c19-8d3d-4f72-b5ae-f2de96787bc0",
"patent_pn": "USD1055174S1",
"rrf_score": 0.030158730158730156,
"risk_level": "High",
"rerank_rank": 10,
"rerank_score": 55,
"traditional_rank": 3,
"traditional_score": 0.875770605053453
}
] | 融合后的专利结果列表,综合传统搜索和AI重排序的结果 |
loc | array | [
"21-01"
] | LOC分类号列表,标识专利的外观设计分类 |
url | string | https://example.com/patent/images/full/0001747893000002.jpg | 专利图像完整URL地址 |
apdt | integer<int32> | 20200115 | 专利申请日期,格式为yyyyMMdd的整数 |
apno | string | US29/961259 | 专利申请号 |
pbdt | integer<int32> | 20210320 | 专利公开日期,格式为yyyyMMdd的整数 |
score必填 | number<double> | 0.875770605053453 | 相似度分数,范围0-1,分数越高表示与用户图像越相似 |
title必填 | string | Inflatable Santa | 专利标题 |
img_id必填 | string | USD1055174-D00000_ABST | 专利图像标识符,用于获取专利图片 |
url_120 | string | https://example.com/patent/images/thumb/0001747893000002_120.jpg | 专利图像缩略图URL地址(120px) |
inventor | string | 张三;李四 | 发明人姓名,多个发明人用分号分隔 |
authority必填 | string | US | 受理局/国家代码,表示专利授权的国家或地区 |
loc_match | integer<int32> | 1 | LOC分类匹配标识:1-匹配,0-不匹配 |
patent_id必填 | string | 3fad2c19-8d3d-4f72-b5ae-f2de96787bc0 | 专利唯一标识符 |
patent_pn必填 | string | USD1055174S1 | 专利公开号 |
rrf_score必填 | number<double> | 0.030158730158730156 | RRF融合得分,综合传统搜索和AI重排序的分数 |
risk_level | string | High | 风险等级:High(高风险)、Medium(中风险)、Low(低风险) |
rerank_rank必填 | integer<int32> | 10 | 在AI重排序结果中的排名(从1开始) |
rerank_score必填 | number<double> | 55 | AI重排序的相似度得分 |
current_assignee | string | 某某科技有限公司 | 当前申请人/受让人名称 |
traditional_rank必填 | integer<int32> | 3 | 在传统图像搜索结果中的排名(从1开始) |
original_assignee | string | 某某科技有限公司 | 原始申请人/受让人名称 |
traditional_score必填 | number<double> | 0.875770605053453 | 传统图像搜索的相似度得分 |
traditional_count必填 | integer<int32> | 200 | 传统图像搜索返回的结果数量 |
line_drawing_base64 | string | data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg== | 线稿图的Base64编码字符串 |
status必填 | boolean | false | 状态 |
error_msg | string | The request parameter format is incorrect! | 错误信息 |
error_code必填 | integer | 0 | 错误代码 |
成功响应示例
成功调用 API 的响应示例
JSON
{
"data": {
"report": {
"loc": [
"02 服装、服饰用品和缝纫用品",
"03 其他类未列入的旅行用品、箱包、阳伞和个人用品",
"10 钟、表及其他测量仪器,检测仪器,信号仪器",
"11 装饰品",
"19 文具、办公用品、美术用品和教学用品",
"21 游戏器具、玩具、帐篷和体育用品",
"32 图形符号、标识、表面图案、纹饰"
],
"country": [
"US",
"CN",
"JP",
"KR",
"AU",
"EU"
],
"comparisons": [
{
"score": 0.45,
"title": "人形",
"img_id": "0001747893000002",
"status": 1,
"country": "JP",
"similar": "主体均为圆柱形结构,且在圆柱面上分布有面部特征。",
"confusion": "虽然基础形状相似,但具体设计元素差异足以区分。",
"patent_id": "09115a22-cf5a-41e1-8e77-11a8fbb3a5b6",
"patent_pn": "JP1747893S",
"risk_desc": "JP标准关注核心要部。尽管基础几何体(圆柱)相似,但头部装饰(帽子 vs 结)和附属件(垂耳 vs 线臂)的差异属于实质性区别。",
"difference": "专利图顶部为复杂的结状/把手结构,两侧为线状手臂,面部特征为传统风格;用户图顶部为圆锥形帽子,两侧为宽扁垂耳,面部有突出的吻部造型。",
"risk_level": "Low",
"suggestion": "保持当前帽子与垂耳的独特组合,以区别于通用的圆柱形玩偶。"
}
],
"operate_date": 1768195176553,
"apply_start_time": 20200101,
"high_risk_country": [
"KR"
],
"middle_risk_country": [
"KR"
],
"suspected_infringement_count": 0,
"suspected_infringement_country": [
"KR"
]
},
"task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"task_status": 2,
"patent_messages": {
"patent_messages": [
{
"loc": [
"21-01"
],
"url": "https://example.com/patent/images/full/0001747893000002.jpg",
"apdt": 20200115,
"apno": "US29/961259",
"pbdt": 20210320,
"score": 0.875770605053453,
"title": "Inflatable Santa",
"img_id": "USD1055174-D00000_ABST",
"url_120": "https://example.com/patent/images/thumb/0001747893000002_120.jpg",
"inventor": "张三;李四",
"authority": "US",
"loc_match": 1,
"patent_id": "3fad2c19-8d3d-4f72-b5ae-f2de96787bc0",
"patent_pn": "USD1055174S1",
"risk_level": "High",
"current_assignee": "某某科技有限公司",
"original_assignee": "某某科技有限公司"
}
],
"total_search_result_count": 156
},
"rrffusion_response": {
"k_value": 60,
"rerank_count": 200,
"patent_messages": [
{
"loc": [
"21-01"
],
"url": "https://example.com/patent/images/full/0001747893000002.jpg",
"apdt": 20200115,
"apno": "US29/961259",
"pbdt": 20210320,
"score": 0.875770605053453,
"title": "Inflatable Santa",
"img_id": "USD1055174-D00000_ABST",
"url_120": "https://example.com/patent/images/thumb/0001747893000002_120.jpg",
"inventor": "张三;李四",
"authority": "US",
"loc_match": 1,
"patent_id": "3fad2c19-8d3d-4f72-b5ae-f2de96787bc0",
"patent_pn": "USD1055174S1",
"rrf_score": 0.030158730158730156,
"risk_level": "High",
"rerank_rank": 10,
"rerank_score": 55,
"current_assignee": "某某科技有限公司",
"traditional_rank": 3,
"original_assignee": "某某科技有限公司",
"traditional_score": 0.875770605053453
}
],
"traditional_count": 200
},
"line_drawing_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg=="
},
"status": true,
"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 | 请求成功 |
201 | Created |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
性能指标
此接口的预期性能特征
正常响应时间
5000 ms
最大响应时间
10000 ms