product-material-check（product material check 工具）

商品素材合规审核Skill

技能名称

商品素材合规审核工具

技能描述

基于网易易盾API的商品素材合规审核工具，支持文本、图片、音视频、文档等多种类型的商品素材违规检测，自动识别广告法违规、政治敏感、侵权风险等问题，并提供详细的修改建议。

技能功能

1. 多类型素材支持：支持文本、图片URL、音视频URL、文档URL
2. 批量输入支持：支持多条文本、多张图片、多个视频、多个文档的批量审核
3. 标准化审核结果：返回0=通过、1=嫌疑、2=不通过的统一格式
4. 智能解析：自动提取llmCheckInfo中的详细审核说明，并关联具体素材ID
5. 精准定位：在审核说明中明确指出哪条文本、哪张图片、哪个视频、哪个文件存在违规
6. 增强重试机制：指数退避策略应对API临时波动
7. Web管理界面：提供直观的浏览器操作界面，支持批量添加素材
8. 公司网络适配：支持代理配置

依赖要求

• Python 3.7+
• requests
• flask
• gmssl（可选，用于SM3签名算法）

安装步骤

1. 申请API密钥： 访问网易易盾官网 dun.163.com ，登录后申请融媒体解决方案的调用密钥，获取SecretId和SecretKey。
2. 下载skill包到本地
3. 安装依赖： pip install requests flask gmssl
4. 配置API密钥： 推荐方式：使用环境变量 export YIDUN_SECRET_ID="your_actual_secret_id" export YIDUN_SECRET_KEY="your_actual_secret_key" 本地测试方式：直接编辑web_app.py 编辑web_app.py文件，直接填写您的网易易盾API密钥（不推荐用于生产环境）

使用方法

方式一：命令行调用

from product_material_check import ProductMaterialChecker
import os

# 从环境变量读取API密钥（推荐）
secret_id = os.getenv("YIDUN_SECRET_ID", "")
secret_key = os.getenv("YIDUN_SECRET_KEY", "")

if not secret_id or not secret_key:
    raise ValueError("请配置YIDUN_SECRET_ID和YIDUN_SECRET_KEY环境变量")

# 初始化审核工具
checker = ProductMaterialChecker(
    secret_id=secret_id,
    secret_key=secret_key,
    signature_method="MD5"
)

# 提交审核
result = checker.check(
    text="商品文本内容",
    image_url="https://example.com/product.jpg",
    title="商品素材审核测试"
)

# 输出结果
print(f"审核建议: {result['suggestion']}")
print(f"审核说明: {result['explain']}")

方式二：Web界面

启动Web服务：

python web_app.py

访问 http://localhost:5004 即可使用Web界面进行审核。

接口说明

ProductMaterialChecker类

__init__方法

def __init__(self, secret_id: str, secret_key: str, signature_method: str = "MD5", proxies: Dict = None)

参数：

• secret_id: 网易易盾API密钥ID
• secret_key: 网易易盾API密钥
• signature_method: 签名算法，默认MD5，支持MD5/SHA1/SHA256/SM3
• proxies: 代理配置，用于公司网络环境

check方法

def check(
    self,
    texts: Optional[Union[str, List[str]]] = None,
    image_urls: Optional[Union[str, List[str]]] = None,
    video_urls: Optional[Union[str, List[str]]] = None,
    document_urls: Optional[Union[str, List[str]]] = None,
    title: Optional[str] = None,
    max_retry: int = 5,
    initial_delay: int = 2
) -> Dict

参数：

• texts: 文本内容列表或单个文本（标题、详情页文字等）
• image_urls: 图片文件URL列表或单个URL
• video_urls: 音视频文件URL列表或单个URL
• document_urls: 文档文件URL列表或单个URL
• title: 审核任务标题
• max_retry: 结果查询最大重试次数，默认5次
• initial_delay: 初始延迟时间（秒），默认2秒

返回值：

{
  "suggestion": 2,
  "explain": "详细审核说明"
}

审核结果说明

• suggestion: 审核建议

- 0 = 审核通过，可以正常上架 - 1 = 存在违规嫌疑，建议人工复核 - 2 = 检测到违规内容，建议修改商品素材

• explain: 详细审核说明，包含所有违规项和修改建议

配置说明

公司网络代理

如果需要通过公司代理访问API，可以在初始化时配置proxies参数：

checker = ProductMaterialChecker(
    secret_id="your_secret_id",
    secret_key="your_secret_key",
    proxies={
        'http': 'http://your-proxy:port',
        'https': 'http://your-proxy:port'
    }
)

常见问题

Q: 签名验证失败怎么办？

A: 请检查secret_id和secret_key是否正确，确保签名算法与网易易盾控制台配置一致。

Q: 审核结果查询超时怎么办？

A: 这是正常现象，API需要一定时间处理审核请求，工具会自动重试。如果多次超时，请检查网络连接或稍后重试。

Q: 支持哪些文件类型？

A: 目前支持通过URL访问的任何类型文件，包括图片、音视频、文档等。

更新日志

v1.0.0 (2026-04-22)

• 初始版本发布
• 支持文本、图片、音视频、文档审核
• 提供Web管理界面
• 支持指数退避重试机制
• 标准化输出格式