侵权综合检测 · 任务状态

查询元素级检索任务的当前状态和完整检索结果。

请求参数

curl -X GET "https://api.trohub.com/v1/infringement/status/4ad62950ca404bc0992b792762d25092" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

url = "https://api.trohub.com/v1/infringement/status/4ad62950ca404bc0992b792762d25092"
headers = {"X-API-Key": "YOUR_API_KEY"}
response = requests.get(url, headers=headers)
print(response.json())

响应示例

外观专利检索示例

{
  "ok": true,
  "message": "成功",
  "data": {
    "taskID": "0cd86dbf6378482e86c5b61e09a75017",
    "status": "completed",
    "imageResults": [
      {
        "imageId": "img_1783862445431_0",
        "imageUrl": "https://...r2.cloudflarestorage.com/trohub-task-images/...png",
        "imageKey": "element-search-images/2/...png",
        "segments": [],
        "searchResults": {
          "designPatent": [
            {
              "title": "Scale",
              "pn": "D0935924",
              "imageUrl": "https://tb-us-design-patents-...cos.ap-shanghai.myqcloud.com/...png",
              "imageKey": "USD0935924-20211116-D00000.png",
              "score": 0.9209,
              "similarity": "92.09%",
              "loc": "10-04",
              "grantDate": "2021/11/16",
              "fillingDate": "2020/05/11",
              "expiryDate": "2036/11/16",
              "imageID": "outline_elem_0cd86dbf6378482e86c5b61e09a75017_0_orig",
              "countryCode": "US",
              "expired": false,
              "owners": [{"name": "Tian Dai", "country": "CN"}],
              "reason": "两者均为带有电子秤功能的勺子，整体轮廓、勺头与手柄的连接方式、显示屏及按键布局高度相似。"
            }
          ]
        },
        "status": "completed",
        "searchScope": {
          "trademarkEnabled": false,
          "designPatentEnabled": true,
          "copyrightEnabled": false,
          "designPatent": {
            "autoSegment": false,
            "removeBg": false,
            "countries": ["US"]
          }
        }
      }
    ],
    "createdAt": "2026-07-12T22:20:49+09:00",
    "updatedAt": "2026-07-12T22:22:03+09:00"
  },
  "responseType": "v2"
}

版权溯源检索示例（含 AI 切图）

{
  "ok": true,
  "message": "成功",
  "data": {
    "taskID": "b6a5e1491ed642a0afb34c25e0f77ba9",
    "status": "completed",
    "imageResults": [
      {
        "imageId": "img_1784521366847_0",
        "imageUrl": "https://...r2.cloudflarestorage.com/trohub-task-images/...png",
        "imageKey": "element-search-images/2/...png",
        "segments": [
          {
            "bbox": [285.35, 271.91, 349.69, 289.09],
            "label": "[copyright] Converse-style sneaker patch",
            "score": 0.85,
            "croppedImage": "https://...r2.cloudflarestorage.com/trohub-task-images/...png",
            "croppedKey": "element-search-images/0/...png",
            "isOriginal": false,
            "detectType": "copyright",
            "searchResults": {
              "copyrightTrace": {
                "entries": [
                  {
                    "id": "C8977033",
                    "imageUrl": "https://search-images.trohub.com/...png",
                    "title": "Skull Embroidered Iron On Patches 32pcs - Amazon",
                    "source": "https://www.amazon.com/..."
                  }
                ],
                "analysis": {
                  "potentialRightsHolders": null,
                  "riskScore": 52,
                  "riskLevel": "medium",
                  "explanation": "检索结果中发现类似风格的刺绣贴片商品...",
                  "matchedEntries": ["C8977033"]
                },
                "ipCheck": {
                  "resemblesKnownIP": true,
                  "matchedIpName": "Converse (Chuck Taylor All Star)",
                  "note": "图片中下排左侧第三个刺绣图案，在造型、配色及鞋带孔细节上与 Converse 经典的 Chuck Taylor All Star 高帮帆布鞋高度相似。",
                  "confidence": "high",
                  "confidenceScore": 75
                }
              }
            }
          }
        ],
        "searchResults": {
          "copyrightTrace": {
            "entries": [
              {
                "id": "C9956082",
                "imageUrl": "https://search-images.trohub.com/...png",
                "title": "Amazon.com: FunnyGifts Kids Backpack with Lunch Box",
                "source": "https://www.amazon.com/..."
              }
            ],
            "analysis": {
              "potentialRightsHolders": null,
              "riskScore": 65,
              "riskLevel": "medium",
              "explanation": "前5条核心结果中，亚马逊平台上的多个店铺均销售图案高度相似的背包...",
              "matchedEntries": ["C9956082"]
            },
            "ipCheck": {
              "resemblesKnownIP": false,
              "matchedIpName": "",
              "note": "该图片为常见的装饰性图案，属于通用题材，未发现与任何知名品牌商标或知名IP作品的特征相符",
              "confidence": "high",
              "confidenceScore": 10
            }
          }
        },
        "status": "completed",
        "searchScope": {
          "trademarkEnabled": false,
          "designPatentEnabled": false,
          "copyrightEnabled": true,
          "copyright": {
            "autoSegment": true,
            "minWidth": 80,
            "minHeight": 80
          }
        }
      }
    ],
    "createdAt": "2026-07-20T12:23:57+08:00",
    "updatedAt": "2026-07-20T12:24:13+08:00"
  },
  "responseType": "v2"
}

字段说明

顶层字段

data 对象

imageResults[] 对象

segments[] 对象

图片中检测到的目标元素（如物体检测框），当启用 autoSegment 时会返回分割后的元素列表。

searchResults.copyrightTrace 对象

版权溯源检索结果。

来源级错误信息

当某个来源（如商标、专利、版权）整体检索失败时，通过以下字段传递错误描述。前端可按来源独立展示失败提示。正常时这些字段不返回。

searchResults.trademark 数组

图形商标检索结果数组，每个元素代表一个匹配到的商标。

trademark[] 对象

tmClass[] 对象

商标类别信息。

owners[] 对象

商标/专利权利人信息。

searchResults.designPatent 数组

外观专利检索结果数组，每个元素代表一个匹配到的外观专利。

designPatent[] 对象

entries[] 对象

analysis 对象

ipCheck 对象

视觉大模型对 query 图片本身的独立品牌/IP 联想识别结果。与候选比对结果完全解耦，用于判断图片是否在视觉上模仿了知名品牌或 IP。

searchScope 对象

本次任务配置的检索范围。

searchScope.copyright 对象

searchScope.trademark 对象

searchScope.designPatent 对象

状态说明

风险等级说明