合规检测系列(需付费 API 套餐)

面向跨境上架的侵权与违禁一站排查:产品图或标题一键检测专利、版权、政策合规与文本商标安全词。这些端点经归一化代理调用第三方数据源,按第三方成本 × 加价计点,需付费 API 套餐(免费额度与赠送点不可用于第三方数据源):免费版调用返回 403 paid_plan_required(未扣点);付费套餐只从套餐月度点扣除,月度点用完返回 402 cash_quota_exhausted。政策特征管理端点免费,全部档位可用。

方法	端点	说明	消耗(API 点)
POST	/v1/patent/design	外观设计专利检索	50(深度 75)
POST	/v1/patent/invention	发明专利检索	50
POST	/v1/copyright/detect	版权侵权检测	5(深度 10)
POST	/v1/policy/image	图片政策合规检测	5
POST	/v1/policy/text	文本政策合规检测	25(每个风险特征词 +10)
POST	/v1/trademark/safe-words	文本商标安全词	5
POST	/v1/policy/feature/{suggest,save,delete,list}	政策特征管理	免费(全部档位)

响应形状

成功响应统一包装,检测结果在 data 里(各端点 data 的确切形状以沙盒为准);成功响应头带 X-Charged(= cost)与 X-Quota-Remaining(= balance):

{
  "ok": true,
  "endpoint": "patent.design",
  "data": { "results": [ { "…": "…" } ], "count": 3 },
  "cost": 50,
  "balance": 18710,
  "request_id": "3f9a1c2b7d4e8f01",
  "partner_request_id": "…",
  "timestamp": "2026-10-10T07:20:01Z"
}

字段	类型	说明
ok	bool	成功为 true;失败为 false,错误体见错误处理
endpoint	string	端点代号:patent.design / patent.invention / copyright.detect / policy.image / policy.text / trademark.safe_words / policy.feature.suggest 等
data	object	归一化后的检测结果;专利 / 版权列表类端点为 results[] + count,其中 results[].is_live 为 bool 或 null(与核名端点的 0/1 不同)
cost	int	本次实际扣除的 API 点,与响应头 X-Charged 同值
balance	int 或 null	扣点后的 API 点余额,与响应头 X-Quota-Remaining 同值;无限量账户为 null 且不发该头
request_id	string	本次请求的追踪 ID,与响应头 X-Request-Id 同值
partner_request_id	string 或 null	第三方数据源侧的请求 ID,排障时请与 request_id 一并提供;命中服务端缓存时为 null
cached	bool	仅命中服务端缓存时出现且为 true:检测类端点(含 policy.feature.suggest)对同一入参有 30 分钟缓存,计费不因缓存而变化;save / delete / list 不缓存
timestamp	string	服务端响应时间,UTC ISO 8601 带 Z

失败时为 { "ok": false, "error": { "code", "message", "retryable" } } 加同样的 request_id / timestamp。本系列特有的 code:bad_json(400,请求体不是合法 JSON)、insufficient_credits(402,余额不足,error 内带 need / balance)、upstream_error(502 / 503,第三方上游失败,已扣点自动退回);其余与错误处理一致。

文本商标安全词入参

/v1/trademark/safe-words 的 trademark_name(命中的商标词)为必填 —— 上游要求,缺失会返回 400「商标传参格式错误」。请求体示例:{"title":"...","trademark_name":"Nike"}。

计费口径

上表为当前价(第三方成本 × 加价系数)。加价系数可调,确切扣点以成功响应体中的 cost 字段为准;深度分析(deep/radar)按括号内价计,文本政策合规开启风险特征词检测时每个特征词另加 10 点。

在线沙盒

这组端点的确切入参与响应、以及一键试跑,见 开发者控制台 的在线沙盒(填参数即可实时调用、看真实返回),比静态文档更准。

鉴权、错误码与核名端点一致(见鉴权 /错误处理)。档位与扣点规则见配额与计费。