商品素材合规审核Skill
技能名称
商品素材合规审核工具
技能描述
基于网易易盾API的商品素材合规审核工具，支持文本、图片、音视频、文档等多种类型的商品素材违规检测，自动识别广告法违规、政治敏感、侵权风险等问题，并提供详细的修改建议。
技能功能
- 多类型素材支持：支持文本、图片URL、音视频URL、文档URL
- 批量输入支持：支持多条文本、多张图片、多个视频、多个文档的批量审核
- 标准化审核结果：返回0=通过、1=嫌疑、2=不通过的统一格式
- 智能解析：自动提取llmCheckInfo中的详细审核说明，并关联具体素材ID
- 精准定位：在审核说明中明确指出哪条文本、哪张图片、哪个视频、哪个文件存在违规
- 增强重试机制：指数退避策略应对API临时波动
- Web管理界面：提供直观的浏览器操作界面，支持批量添加素材
- 公司网络适配：支持代理配置
依赖要求
- Python 3.7+
- requests
- flask
- gmssl（可选，用于SM3签名算法）
安装步骤
- 申请API密钥： 访问网易易盾官网 dun.163.com ，登录后申请融媒体解决方案的调用密钥，获取SecretId和SecretKey。
- 下载skill包到本地
- 安装依赖：
pip install requests flask gmssl - 配置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密钥IDsecret_key: 网易易盾API密钥signature_method: 签名算法，默认MD5，支持MD5/SHA1/SHA256/SM3proxies: 代理配置，用于公司网络环境
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列表或单个URLvideo_urls: 音视频文件URL列表或单个URLdocument_urls: 文档文件URL列表或单个URLtitle: 审核任务标题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管理界面
- 支持指数退避重试机制
- 标准化输出格式