提交图片进行外观专利近似检索。系统会自动检测图片中的产品外观、设计元素等,然后在外观专利库中进行跨库比对。支持多图片同时检索,每张图片可独立配置检索范围。
启用规则(重要):
designPatentEnabled控制是否启用外观专利检索designPatent详细配置对象仅在designPatentEnabled=true时生效- 当
designPatentEnabled=true时,designPatent对象必须设置,否则返回 400 错误
请求参数
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
taskID | string | ❌ | UUID | 自定义的任务唯一 ID (UUID),不传则自动生成 |
images | array | ✅ | [] | 图片列表,限制 1 至 10 个 |
images[].imageID | string | ❌ | "" | 前端生成的图片唯一标识 |
images[].image | string | ✅ | "" | 可公开访问的图片地址或 base64 图片 |
images[].searchScope | object | ✅ | {} | 该图片的检索范围配置 |
images[].searchScope.designPatentEnabled | boolean | ✅ | false | 是否启用外观专利检索(设为 true) |
images[].searchScope.designPatent | object | ✅ | {} | 外观专利检索配置(当 designPatentEnabled=true 时必须提供) |
images[].searchScope.designPatent.productName | string | ❌ | "" | 产品名称描述,用于辅助品类过滤。虽然可选,但建议带上产品核心词或产品名称 |
images[].searchScope.designPatent.autoSegment | boolean | ❌ | false | 是否启用 AI 自动裁剪检测元素 |
images[].searchScope.designPatent.minWidth | number | ❌ | 100 | AI 自动裁剪的最小宽度(像素) |
images[].searchScope.designPatent.minHeight | number | ❌ | 100 | AI 自动裁剪的最小高度(像素) |
images[].searchScope.designPatent.removeBg | boolean | ❌ | false | 是否移除背景后检索 |
images[].searchScope.designPatent.countries | array | ✅ | ["US"] | 专利国家过滤列表(如 ["US", "EU"]) |
提示:在
images[].searchScope中,仅需设置designPatentEnabled=true并填写designPatent配置,无需设置其他检索源(trademarkEnabled、copyrightEnabled等保留为false或省略即可)。
请求示例
cURLPython
curl -X POST "https://api.trohub.com/v1/infringement/image-search" \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"taskID":"patent-demo-uuid","images":[{"imageID":"img-dp-001","image":"https://example.com/images/product.jpg","searchScope":{"designPatentEnabled":true,"designPatent":{"autoSegment":false,"removeBg":false,"countries":["US"],"productName":"wireless headphone"}}}]}'import requests
url = "https://api.trohub.com/v1/infringement/image-search"
headers = {
"X-API-Key": "YOUR_API_KEY",
"Content-Type": "application/json"
}
payload = {
"taskID": "patent-demo-uuid",
"images": [{
"imageID": "img-dp-001",
"image": "https://example.com/images/product.jpg",
"searchScope": {
"designPatentEnabled": True,
"designPatent": {
"autoSegment": False,
"removeBg": False,
"countries": ["US"],
"productName": "wireless headphone" #建议填写
}
}
}]
}
response = requests.post(url, headers=headers, json=payload)
print(response.json()) 🔧 API 沙盒测试 POST
/infringement/image-search 响应示例
{
"success": true,
"message": "Element search tasks submitted successfully",
"data": {
"taskIDs": [
"h0d0a0b3-f09c-4824-a745-0d29759c253h"
]
}
}