睿观 ERiC 合规检测套件#

API Key 获取方式#

关注微信公众号【睿观AI】，发送消息："睿观Skill"，即可获取 API Key。

获取后请设置环境变量：

bash

export ERIC_API_TOKEN="你获取到的 API Key"

扣点说明（首次使用必读）#

检测模式基础扣点开启雷达后说明D001 外观专利10 点15 点默认开启雷达I001 发明专利10 点-无雷达功能L001 图形商标10 点15 点默认开启雷达T001 文本商标1 点-无雷达功能T002 商标替换词1 点-按词计费C001 版权检测1 点2 点默认开启雷达P001 政策-纯图1 点--P002 政策-纯文本5 + 特征词数×2 点-图文同时入参仍为 5+2n 点

重要提示:

• 带雷达的检测模式（D001、L001、C001）默认开启雷达以获得更精准的结果
• 检测开始前会提示预扣点数，检测完成后会显示实际扣点
• 如客户端超时导致重试，会说明实际扣费情况

功能导航#

根据用户需求选择对应的 API：

用户需求API输入类型参考文档产品图片查外观专利侵权D001图片design-patent.md产品标题/描述查发明专利侵权I001文本invention-patent.md产品图片查图形商标(logo)侵权L001图片logo-detection.md产品标题/描述查文本商标风险T001文本trademark-detection.md为高风险商标词找安全替换词T002文本trademark-detection.md产品图片查版权画侵权C001图片copyright-detection.md产品图片查违禁品（枪械配件等）P001图片policy-detection.md产品文本查平台销售政策合规P002文本policy-detection.md管理自定义风险特征词P004-P007文本policy-detection.md

上下文保护#

• 禁止将 base64 图片、大体积二进制数据读入 Agent 上下文。 图片编码和 API 调用必须在代码执行环境中完成。
• API 响应过大时，先在代码执行环境中提取关键字段摘要再呈现给用户。
• 涉及图片的接口：D001、L001、C001、P001。

认证配置#

所有接口共用同一 Token。调用前需确认环境变量 ERIC_API_TOKEN 已设置。若未设置，提示用户：

text

未检测到 ERIC_API_TOKEN 环境变量。请先完成配置：
1. 登录睿观平台 https://eric-bot.com 获取 API Token
2. 设置环境变量：export ERIC_API_TOKEN=your_token

所有请求的公共 Headers： Content-Type: application/json、 Token: <API_TOKEN>

调用方式#

统一入口脚本 scripts/detect.py，通过子命令区分 API：

bash

# D001 外观专利检测
python scripts/detect.py d001 /path/to/image.png --regions US GB --top 50

# I001 发明专利检测
python scripts/detect.py i001 --title "产品标题" --description "产品描述" --regions US

# L001 图形商标检测
python scripts/detect.py l001 /path/to/image.png --top 20 --regions US --enable-radar

# T001 文本商标检测 (--auto-safe-words 自动为高风险词调 T002)
python scripts/detect.py t001 --title "Ps4 Wireless Controller" --text "描述..." --regions US JP --auto-safe-words

# T002 商标替换词
python scripts/detect.py t002 --title "产品标题" --text "产品描述" --trademark "商标词"

# C001 版权检测
python scripts/detect.py c001 /path/to/image.png --top 100 --enable-radar

# P001 政策合规-纯图检测
python scripts/detect.py p001 /path/to/image.png

# P002 政策合规-纯文本检测
python scripts/detect.py p002 --title "产品标题" --description "描述" --sites us jp

# P004 风险特征词联想
python scripts/detect.py p004 "模糊词"

# P005/P006/P007 特征词管理
python scripts/detect.py p005 "特征词"
python scripts/detect.py p006 123
python scripts/detect.py p007 --per-page 50 --page 1

所有子命令均支持 --json 输出原始 API 响应。使用 python scripts/detect.py <子命令> --help 查看完整参数。

D001 外观专利检测#

通过产品图片搜索相似外观专利，按相似度排序，单次最多 500 条。

• URL: POST https://saas.eric-bot.com/v1.0/eric-api/patent/design/v1/detection
• 必需参数: img_64lis(图片base64数组), regions(国家代码), top_number(1-500), enable_tro(bool), query_mode("hybrid"/"physical"/"line")
• 可选参数: product_title, product_description, top_loc, patent_status, source_language, enable_radar
• 关键响应: data.list[] 含 similarity, patent_prod, publication_number, patent_validity, tro_holder, radar_result
• 风险判断: similarity > 0.8 或 radar_result.same = true 或 tro_holder = true → 高风险
• 费用: 10 点/次（ 默认开启雷达 15 点/次）
• 默认站点: US

详细参数、响应字段、错误码和代码示例见 references/design-patent.md。

I001 发明专利检测#

通过产品标题和描述搜索相似发明专利，当前仅支持 US。

• URL: POST https://saas.eric-bot.com/v1.0/eric-api/patent/utility/v1/detection
• 必需参数: product_title, product_description, regions(仅["US"]), top_number(1-500)
• 关键响应: data.data[] 含 similarity(number), title, abstract, publication_number, cpc_classification[], specification_url, claims_url
• 风险判断: similarity > 0.8 → 高风险
• 费用: 10 点/次
• 默认站点: US（当前仅支持 US）

详细参数、响应字段、错误码和代码示例见 references/invention-patent.md。

L001 图形商标检测#

通过产品图片识别 logo 区域并搜索相似已注册图形商标，单次最多 100 条。

• URL: POST https://saas.eric-bot.com/v1.0/eric-api/trademark/graphic/v1/detection
• 必需参数: base64_image, top_number(1-100)
• 可选参数: product_title, trademark_name, regions(15个国家), enable_localizing, enable_radar
• 关键响应: data.detection_results[] → top_graphic_trademarks[] → graphic_trademarks[] 含 similarity, trademark_name, applicant_name, trade_mark_status, nice_class[], sub_radar_result
• 风险判断: sub_radar_result = "high_risk" 或 similarity > 0.8 → 高风险
• 费用: 10 点/次（ 默认开启雷达 15 点/次）
• 默认站点: 全部（US, WO, ES, GB, DE, IT, CA, MX, EM, AU, FR, JP, TR, BX, CN）

详细参数、响应字段、错误码和代码示例见 references/logo-detection.md。

T001 文本商标检测 + T002 替换词#

T001 检测产品文本中的商标词及风险等级；T002 为高风险词生成安全替换词。

T001 文本商标检测#

• URL: POST https://saas.eric-bot.com/v1.0/eric-api/trademark/text/v1/detection
• 必需参数: product_title(≤300字符)
• 可选参数: product_text(≤5000字符), regions(支持15个国家: AU, BX, CA, DE, EM, ES, FR, GB, IT, JP, MX, TR, US, WO, CN)
• 关键响应: data.text_trademarks[] 含 trademark_name, highest_mode_score(0-5), status, is_active_holder, is_famous, region_score[]； data.text_trademark_radar(0=低风险/1=待核查/2=高风险)
• 费用: 1 点/次
• 超时: 90 秒
• 默认站点: US

T002 商标替换词#

• URL: POST https://saas.eric-bot.com/v1.0/eric-api/trademark/text/v1/safe-words-generation
• 必需参数: product_title, product_text, trademark_name(T001检出的单个商标词)
• 关键响应: data.words[] 推荐替换词
• 费用: 1 点/次

工作流: 首次检测只调用 T001（扣 1 点）， 不自动调用 T002。如需获取替换词，用户需手动指定 --auto-safe-words 参数，此时会为 highest_mode_score >= 3 的词调 T002 获取替换建议。

详细参数、响应字段、错误码和代码示例见 references/trademark-detection.md。

C001 版权检测#

通过产品图片搜索相似版权画作，单次最多 200 条。

• URL: POST https://saas.eric-bot.com/v1.0/eric-api/copyright/v1/detection
• 必需参数: img_64lis(图片base64数组), top_number(默认100, 最大200), enable_radar(bool)
• 关键响应: data.list[] 含 similarity(相似度), path(版权画图片), rights_owner, copyright_code, copyright_url, sub_radar_result, tro_holder
• 风险判断: similarity > 0.8 或 sub_radar_result = "high_risk" → 高风险
• 费用: 1 点/次（ 默认开启雷达 2 点/次）

详细参数、响应字段、错误码和代码示例见 references/copyright-detection.md。

P001-P007 政策合规检测#

检测产品是否违反电商平台销售政策，并管理风险特征词。

P001 纯图检测#

• URL: POST https://saas.eric-bot.com/v1.0/eric-api/policy-compliance/v1/gun-parts-search
• 必需参数: base64_image, type(当前仅 ["gun_parts"])
• 关键响应: data.list[] 含 pd_title, pd_img_oss_url, cosine
• 后续: cosine >= 0.4 时建议调 P002 确认具体违反的政策
• 费用: 1 点/次

P002 纯文本检测#

• URL: POST https://saas.eric-bot.com/v1.0/eric-api/policy-compliance/v1/detection
• 必需参数: product_title, platform_sites(如 {"amazon":["us","jp"]}), feature_detect(含 enable, features)
• 可选参数: product_description, type(P001有结果时传), product_title_suspected
• 关键响应: data.list[] 含 prohibited(1=禁售), compliance(1=限售), reason, content_url, name
• 费用: 5 + 特征词数×2 点/次（ 图文同时入参检测仍为 5+2n 点，不分开计费）
• 默认站点: us
• 支持站点: br, fr, au, us, uk(非gb), jp, it, es, mx, de, ca

P004-P007 风险特征词管理#

操作URL 路径参数P004 联想policy-compliance/feature/v1/suggestion``word(模糊词)P005 保存policy-compliance/feature/v1/save``wordP006 删除policy-compliance/feature/v1/delete``idP007 列表policy-compliance/feature/v1/list``per_page, page

URL 前缀: https://saas.eric-bot.com/v1.0/eric-api/

详细参数、响应字段、错误码和代码示例见 references/policy-detection.md。

通用错误处理#

所有接口共用以下错误码：

code含义处理建议30007Token 无效检查 API Token100007参数错误检查必填字段4000011-4000014积分不足/扣点失败登录 eric-bot.com 充值4000020-4000021图片上传失败检查图片格式和大小5000504请求超时稍后重试0 / 500系统异常稍后重试

各接口专属错误码见对应 references/ 文档。