侵权综合检测 · 任务状态

查询元素级综合任务进度与结果

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

请求参数

参数类型必填说明
taskIDstring✅任务 ID (提交任务返回的 taskID)
cURLPython 
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())
🔧 API 沙盒测试 GET /infringement/status/:taskID

响应示例

{
  "ok": true,
  "message": "成功",
  "data": {
    "taskID": "dee8b0c107514f2fa46404e741025df5",
    "userId": 2,
    "status": "completed",
    "imageResults": [
      {
        "imageId": "img_1783851829049_0",
        "imageUrl": "https://...r2.cloudflarestorage.com/trohub-task-images/...png",
        "imageKey": "element-search-images/2/...png",
        "detections": [],
        "searchResults": {
          "copyrightTrace": {
            "entries": [
              {
                "id": "C3753111",
                "imageUrl": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSBeDUaMOoG4h3Sr_AqoJeO32MB_8wnqZZOpRLaGD7kIG8hFLe3",
                "imageKey": "element-search-images/ddede3b20a9f40ac8a623b5be6062673.png",
                "title": "PYR to Publish New Book Based on Most-Watched Bluey Episode Ever | Penguin Random House",
                "source": "https://global.penguinrandomhouse.com/announcements/pyr-to-publish-new-book-based-on-most-watched-bluey-episode-ever/"
              },
              {
                "id": "C5239775",
                "imageUrl": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSpd7OMv2jey_m4ZmswYK2B65Lg8uP6dXEZfLgE2T9WNh2JytUW",
                "imageKey": "element-search-images/fd2acc4e06fc4988af46bb3878442682.png",
                "title": "Bluey - Family Wall Poster, 22.4L\" x 14.7W\", Black Framed Version: Posters & Prints - Amazon.com",
                "source": "https://www.amazon.com/Trends-International-Bluey-Family-Poster-Version/dp/B09GKSTXBM"
              }
            ],
            "analysis": {
              "potentialRightsHolders": null,
              "riskScore": 92,
              "riskLevel": "high",
              "explanation": "检索结果前5条核心条目...",
              "matchedEntries": ["C3753111", "C5239775", "C4266421", "C6421190", "C8347607"]
            }
          }
        },
        "queryAssessment": {
          "resemblesKnownIP": true,
          "note": "图片展示了知名动画IP《布鲁伊》（Bluey）的特别篇《The Sign》的官方海报...",
          "confidence": "high",
          "confidenceScore": 80
        },
        "status": "completed",
        "searchScope": {
          "trademarkEnabled": false,
          "designPatentEnabled": false,
          "copyrightEnabled": true,
          "copyright": {
            "autoSegment": false
          }
        }
      }
    ],
    "createdAt": "2026-07-12T18:24:02+08:00",
    "updatedAt": "2026-07-12T18:24:29+08:00"
  },
  "responseType": "v2"
}

字段说明

顶层字段

字段类型说明
okboolean请求是否成功。true 表示成功，false 表示失败
messagestring请求结果描述信息，成功时返回 "成功"，失败时返回错误原因
responseTypestring响应版本标识，当前为 "v2"
dataobject响应数据主体，包含任务详情与检索结果

data 对象

字段类型说明
taskIDstring任务唯一标识符，可用于后续查询任务状态
userIdnumber提交任务的用户 ID
statusstring任务状态。可选值：pending（排队中）、processing（处理中）、searching（检索中）、completed（已完成）、failed（失败）
imageResultsarray图片检索结果数组，每张图片对应一个结果对象
createdAtstring (ISO 8601)任务创建时间，格式为 YYYY-MM-DDTHH:mm:ss+08:00
updatedAtstring (ISO 8601)任务最近更新时间，格式为 YYYY-MM-DDTHH:mm:ss+08:00

imageResults[] 对象

字段类型说明
imageIdstring当前图片的唯一标识，格式如 img_{timestamp}_{index}
imageUrlstring上传图片的公开访问 URL（含临时签名，有时效性）
imageKeystring图片在对象存储中的 Key，用于后端定位资源
detectionsarray图片中检测到的目标元素（如物体检测框），为空数组表示未启用或未检测到
searchResultsobject版权/商标/外观专利等检索结果聚合对象
queryAssessmentobject查询图片评估信息，描述图片内容是否疑似受知识产权保护
statusstring当前图片的检索状态。可能值：pending、processing、searching、completed、failed
searchScopeobject本次任务启用的检索范围配置

searchResults.copyrightTrace 对象

版权溯源检索结果。

字段类型说明
entriesarray版权匹配结果条目列表，每个条目表示一个疑似使用了该图片的网页/商品链接
analysisobject综合风险分析结果，包含风险评分、风险等级和说明

entries[] 对象

字段类型说明
idstring条目的唯一标识，格式如 "C{7位数字}"（C 表示 Copyright）
imageUrlstring该条目中匹配到的图片缩略图 URL（Google 加密图床，有时效性）
imageKeystring该条目匹配图片在对象存储中的 Key
titlestring匹配页面 / 商品的标题，可用于快速判断内容相关性
sourcestring匹配页面的完整 URL 链接，用户可点击跳转查看原文

analysis 对象

字段类型说明
potentialRightsHoldersstring or null潜在的权利人/版权方名称。null 表示未明确识别出具体权利人
riskScorenumber侵权风险评分，取值范围 0~100。数值越高表示侵权风险越大
riskLevelstring风险等级。根据 riskScore 划分："low"（低风险 0-40）、"medium"（中风险 41-70）、"high"（高风险 71-90）、"critical"（极高风险 91-100）
explanationstring风险分析的详细说明文字，解释为何匹配到该风险等级，以及相关版权/IP 背景信息
matchedEntriesarray参与风险评分的核心匹配条目 ID 列表，引用 entries[].id 字段

queryAssessment 对象

查询图片的初步评估信息，基于图片内容识别判断其知识产权属性。

字段类型说明
resemblesKnownIPboolean图片内容是否与已知的知识产权（IP，如知名角色、品牌 Logo、受版权保护的作品等）相似
notestring对图片内容的自然语言描述和评估说明，解释为何被判定为疑似侵权
confidencestring评估置信度等级。可选值："low"（低）、"medium"（中）、"high"（高）
confidenceScorenumber评估置信度数值，取值范围 0~100。数值越高表示模型对评估结果越确信

searchScope 对象

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

字段类型说明
trademarkEnabledboolean是否启用了商标检索。true 表示开启
designPatentEnabledboolean是否启用了外观专利检索。true 表示开启
copyrightEnabledboolean是否启用了版权检索。true 表示开启
copyrightobject版权检索的详细配置

searchScope.copyright 对象

字段类型说明
autoSegmentboolean是否自动对图片进行分割后再进行版权检索。true 表示启用，适用于包含多个元素的复合图片

状态说明

状态值说明
pending任务已提交，等待处理
processing正在处理图片（检测、分割等预处理）
searching正在进行外部检索比对（版权/商标/专利）
completed所有检索已完成，可获取结果
failed任务处理失败

风险等级说明

风险等级分值范围说明
low0 ~ 40低风险，检索结果中未发现明显侵权内容
medium41 ~ 70中风险，存在部分相似结果，建议进一步人工核查
high71 ~ 90高风险，检索结果中匹配到较多相关侵权内容
critical91 ~ 100极高风险，匹配到核心版权/商标内容，需要立即关注