适用场景哪些业务需要文本审核接口任何涉及用户生成内容UGC的平台都可能面临违规文本带来的合规风险。典型场景包括社区评论论坛、微博、视频弹幕实时过滤恶意评论、政治敏感、色情低俗内容。即时通讯聊天消息、群公告防止涉政、违法信息扩散。产品反馈售后工单、用户投诉文本在公开前自动屏蔽攻击性内容。AI对话日志对LLM生成的回复做二次审核拦截幻觉产生的违规输出。内容发布博客、文章、商品描述在上线前进行多维度安全检测。文本审核接口为上述场景提供了一套开箱即用的策略返回“合规/不合规/疑似”三态结论附带命中违规词详情帮助运营人员快速决策或触发人工复审流程。接口能力边界知道它能做什么才知道怎么用请求容量与性能上限维度数值说明单次文本长度1–5000 字符中英文均按1字符计超过5000字符需截断或分片QPS5 / s每秒最多5次请求超限可能返回429或触发降级并发策略HTTP短连接建议复用连接池但注意服务端对长连接的支持按实际环境为准审核维度与三态结论接口对文本进行多维度扫描覆盖政治敏感、谩骂、色情、违规广告、暴恐、低俗等类别。每一条命中违规信息包含category违规类别如政治、色情word触发词原文level严重等级数值越高越严重msg可读的说明文字返回结论通过三个布尔字段表达{ is_compliant: true, is_suspected: false, // 若is_compliant为true则视为合规 }三态逻辑如下is_compliantis_suspected结论推荐处理truefalse合规放行falsefalse不合规拒绝/屏蔽falsetrue疑似人工复审或二次拦截注意素材中的响应示例显示“is_compliant: false, is_suspected: false”说明该示例文本“法轮功是邪教组织”被明确判定为不合规不需要人工复核。隐私保护机制接口在缓存和日志层面做了隐私约束缓存key对原文做SHA256哈希原文不入key。错误日志不记录文本内容仅记录request_id与错误码。这意味着即便缓存命中或日志泄漏攻击者也无法还原原始文本适合处理敏感用户数据。请求参数详解Header与BodyHeader鉴权接口支持两种鉴权方式二选一或同时提供AuthorizationBearer Token格式Authorization: Bearer sk_live_xxxxxxxxxxxxxx非必填若填写则使用该密钥鉴权匿名调用省略时每日有30次免鉴权限额。X-API-Keycurl示例中使用格式X-API-Key: sk_live_xxxxxxxxxxxxxx与Authorization等效但实际服务端按一方优先处理文档未明确定义优先级建议只使用其中一种。Content-Type支持两种application/json推荐application/x-www-form-urlencoded若使用JSON请求体为一个包含text字段的对象。请求Body字段字段类型必填描述示例textstring是待审核文本1-5000字符今天天气不错适合出门散步。这里没有其他字段结构极简。curl示例与代码接入直接使用curl以下示例使用X-API-Key头请将$APIZERO_API_KEY替换为真实的API密钥curl -sS \ -X POST \ -H X-API-Key: $APIZERO_API_KEY \ -H Content-Type: application/json \ -d {text: 今天天气不错适合出门散步。} \ https://v1.apizero.cn/api/text-censor如果你使用Authorization头可以写成curl -sS \ -X POST \ -H Authorization: Bearer sk_live_xxxxxxxxxxxxxx \ -H Content-Type: application/json \ -d {text: 测试违规内容} \ https://v1.apizero.cn/api/text-censor提示匿名调用时省略Authorization或X-API-Key头即可但每天仅30次接口调用。生产环境务必配置密钥。使用Pythonrequests库import requests import json API_URL https://v1.apizero.cn/api/text-censor API_KEY sk_live_xxxxxxxxxxxxxx # 替换为真实密钥 headers { Content-Type: application/json, Authorization: fBearer {API_KEY} } data {text: 今天天气不错适合出门散步。} resp requests.post(API_URL, headersheaders, jsondata) result resp.json() print(json.dumps(result, indent2, ensure_asciiFalse))使用Node.jsaxiosconst axios require(axios); const API_URL https://v1.apizero.cn/api/text-censor; const API_KEY sk_live_xxxxxxxxxxxxxx; // 替换 axios.post(API_URL, { text: 今天天气不错适合出门散步。 }, { headers: { Authorization: Bearer ${API_KEY}, Content-Type: application/json } } ).then(response { console.log(JSON.stringify(response.data, null, 2)); }).catch(err console.error(err));返回值解读字段拆解与前端展示建议完整的成功响应结构如下已去除外层数组包裹{ code: 0, msg: 成功, request_id: abc123def456, data: { is_compliant: false, is_suspected: false, conclusion: 不合规, conclusion_type: 2, text: 法轮功是邪教组织, text_length: 8, details: [ { category: 政治, level: 3, msg: 存在政治内容不合规, word: 法轮功 }, { category: 政治, level: 3, msg: 存在政治内容不合规, word: 邪教 } ], violations: [法轮功, 邪教], violation_categories: [政治], violation_count: 2 } }关键字段说明字段类型含义codeint业务状态码0表示成功非0参见错误码request_idstring请求唯一标识排障时需提供data.is_compliantbool是否完全合规data.is_suspectedbool是否疑似违规需要人工复核data.conclusionstring中文结论合规 / 不合规 / 疑似data.conclusion_typeint结论数字标识1合规 / 2不合规 / 3疑似根据素材示例推断建议以文档为准data.detailsarray命中违规详情列表每个元素包含category/word/level/msgdata.violationsarray[string]去重后的违规词数组data.violation_categoriesarray[string]去重后的违规类别数组data.violation_countint违规条目总数前端快速展示方案利用violations、violation_categories、violation_count三个衍生字段前端无需再遍历details即可展示统计信息例如“触发 2 项违规政治”点击详情可展开显示具体词“法轮功”、“邪教”。常见错误排查错误现象可能原因排查思路响应401API密钥无效或未提供检查密钥前缀是否为sk_live_确认请求头正确响应429超出QPS配额5/s增加重试退避或降低请求频率响应413请求体过大检查text字段长度是否超过5000字符响应400JSON格式错误或缺少必填字段验证请求体是否为合法JSONtext字段是否存在响应500服务端异常记录request_id联系技术支持文档链接见后匿名调用提示“rate limit”匿名用户每日30次已用完升级为带密钥调用工程化注意事项1. 限流与重试机制由于QPS上限为5建议在客户端实现令牌桶或固定窗口限流。使用指数退避重试例如第一次等待200ms第二次500ms第三次1s应对429。若业务并发需求远超5应考虑将文本分批发送或与平台协商提升配额具体规则以官方文档为准。2. 请求分片策略对于超过5000字符的文本需要手动切分。切分策略应尽量保持语义完整优先按段落换行符切分每段不超过5000字符。若段落超长按标点符号句号、问号切分。切分后逐段调用接口最终合并结果任一子段不合规则整体判定为不合规。3. 缓存与降级对已审核的文本计算SHA256存入本地缓存TTL根据业务调整避免重复请求浪费配额。若接口不可用可降级为“疑似”等待人工审核或使用本地简单规则如正则屏蔽常见违禁词作为兜底。4. 隐私与合规生产环境务必使用HTTPS避免明文传输用户文本。即使接口不记录文本内容业务方也应遵循自身隐私政策在调用前告知用户“内容将通过第三方审核服务检查”。5. 异步处理与回调若审核非实时必要如用户发表内容后先发布再异步追查可采用消息队列将审核任务异步处理失败时记录日志并触发告警。接口本身为同步设计不支持callback回调。参考文档接口文档页https://apizero.cn/aidocs/text-censor原始接口文档Markdownhttps://apizero.cn/aidocs/text-censor/raw.md
