提交图片进行外观专利近似检索。系统会自动检测图片中的产品外观、设计元素等,然后在外观专利库中进行跨库比对。支持多图片同时检索,每张图片可独立配置检索范围。

启用规则(重要)

  • designPatentEnabled 控制是否启用外观专利检索
  • designPatent 详细配置对象仅在 designPatentEnabled=true 时生效
  • designPatentEnabled=true 时,designPatent 对象必须设置,否则返回 400 错误

请求参数

参数类型必填默认说明
taskIDstringUUID自定义的任务唯一 ID (UUID),不传则自动生成
imagesarray[]图片列表,限制 1 至 10 个
images[].imageIDstring""前端生成的图片唯一标识
images[].imagestring""可公开访问的图片地址或 base64 图片
images[].searchScopeobject{}该图片的检索范围配置
images[].searchScope.designPatentEnabledbooleanfalse是否启用外观专利检索(设为 true
images[].searchScope.designPatentobject{}外观专利检索配置(当 designPatentEnabled=true 时必须提供)
images[].searchScope.designPatent.productNamestring""产品名称描述,用于辅助品类过滤。虽然可选,但建议带上产品核心词或产品名称
images[].searchScope.designPatent.autoSegmentbooleanfalse是否启用 AI 自动裁剪检测元素
images[].searchScope.designPatent.minWidthnumber100AI 自动裁剪的最小宽度(像素)
images[].searchScope.designPatent.minHeightnumber100AI 自动裁剪的最小高度(像素)
images[].searchScope.designPatent.removeBgbooleanfalse是否移除背景后检索
images[].searchScope.designPatent.countriesarray["US"]专利国家过滤列表(如 ["US", "EU"]

提示:在 images[].searchScope 中,仅需设置 designPatentEnabled=true 并填写 designPatent 配置,无需设置其他检索源(trademarkEnabledcopyrightEnabled 等保留为 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"
    ]
  }
}