/v1/text/checks提交文案检测
提交一段文案做合规检测,立即返回 id,检测在后台异步进行。
拿到 id 后轮询 GET /v1/text/checks/{id},直到 status 变成 completed 或 failed(通常 3–15 秒)。
支持三条产品线:creator(短视频)、duanju(短剧)、touliu(投放),由 productVertical 指定。
提交即扣积分;入队失败会自动全额退回。
请求体
| 字段 | 类型 | 说明 |
|---|---|---|
| text必填 | 字符串 | 待检测文案。10–5000 字。(长度 10–5000) |
| platform必填 | 枚举 | 发布平台。决定命中哪套平台规则。短剧场景通常用 hongguo(红果)。可选值:douyin抖音kuaishou快手xiaohongshu小红书shipinhao视频号bilibiliB 站hongguo红果短剧 |
| industryVertical必填 | 枚举 | 行业垂类。与产品线正交,决定行业专项规则(如医美、金融、保健食品)。可选值:general通用(不限行业)beauty美妆护肤ecommerce电商直播finance金融财经health医疗健康food保健食品slimming减肥瘦身 |
| productVertical | 枚举 | 产品线:creator=短视频创作合规(默认)、duanju=短剧、touliu=投放素材。决定命中哪套规则集与自定义词库。可选值:creator短视频duanju短剧touliu投放默认 creator |
| sceneMode | 枚举 | 内容场景:content=纯内容创作(默认)、ad=广告投放。声明 ad 后,场景类提示(kind=scene-hint)不再计为违规。可选值:content纯内容创作ad广告投放默认 content |
| autoFix | 布尔 | 是否在检测完成后自动触发 AI 修复。开启会额外扣除修复积分;结果在 fixes 数组里返回。默认 false |
响应201
| 字段 | 类型 | 说明 |
|---|---|---|
| id | 字符串 | 本次检测的 id,用于轮询结果。 |
| object | 字符串 | 对象类型。 |
| status | 字符串 | 当前状态。刚提交时为 processing。 |
示例
curl -X POST https://www.byerisk.com/api/v1/text/checks \
-H "Authorization: Bearer $BYERISK_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"text": "这款面膜是全网最好的,七天美白见效,无效退款!",
"platform": "douyin",
"industryVertical": "beauty",
"productVertical": "creator",
"sceneMode": "content",
"autoFix": false
}'{
"success": true,
"data": {
"id": "cms8xhc5x0006sp59vrks7zkf",
"object": "text_check",
"status": "processing"
}
}