适用场景文本审核接口适用于需要实时或近实时检测用户生成文本中违规内容的业务场景例如社交平台评论 / 帖子发布前预审即时通讯消息过滤社区论坛内容发布审核直播弹幕关键词拦截反馈 / 投诉文本自动分类这类场景对接口的调用频率、单次请求长度以及鉴权方式有严格的边界约束本文将围绕这些边界展开说明。接口能力边界QPS 限制接口的读写共享 QPS 为5 次/秒。超过该频率的请求将返回429 Too Many Requests建议客户端在发请求前做本地限速例如使用令牌桶算法或采用异步队列控制并发。单次请求文本长度最大长度5000 字符中英文均按 1 字符计算最小长度1 字符空字符串会返回参数错误超过 5000 字符时接口返回400 Bad Request错误信息提示字段超长。鉴权限制接口支持两种鉴权模式模式Header 示例说明API Key 鉴权Authorization: Bearer sk_live_xxxxxxxxxxxxxx无调用次数限制受 QPS 约束匿名调用不传Authorization头每日最多30 次调用超出后返回403 Forbidden匿名调用额度适用于快速验证和原型开发生产环境应使用 API Key。数据隐私与缓存缓存 key 使用sha256(text)哈希原始文本不会出现在缓存键中错误日志不记录输入的文本原文响应中返回的text字段为请求时的原文仅用于核对请求参数与鉴权请求信息请求方法POST请求地址https://v1.apizero.cn/api/text-censorContent-Type支持application/json或application/x-www-form-urlencodedHeader 参数参数必填类型说明Authorization否stringAPI Key 鉴权格式Bearer sk_live_xxx匿名调用时不传Content-Type否string默认application/json请求体JSON 示例{ text: 今天天气不错适合出门散步。 }字段说明字段类型必填说明textstring是待审核文本1–5000 字符中英文均按 1 字符计可复制的 curl 示例1. 使用 API Key 鉴权推荐# 替换 YOUR_API_KEY 为真实的 sk_live_xxx 密钥 curl -sS -X POST \ -H Authorization: Bearer YOUR_API_KEY \ -H Content-Type: application/json \ -d {text: 法轮功是邪教组织} \ https://v1.apizero.cn/api/text-censor2. 匿名调用每日 30 次# 不传 Authorization 头系统自动视为匿名调用 curl -sS -X POST \ -H Content-Type: application/json \ -d {text: 今天天气不错适合出门散步。} \ https://v1.apizero.cn/api/text-censor返回结果中text字段会原样回显请求的文本可用于前端核对。返回值解读响应采用统一 JSON 结构示例{ code: 0, msg: 成功, request_id: abc123def456, data: { text: 法轮功是邪教组织, text_length: 8, is_compliant: false, is_suspected: false, conclusion: 不合规, conclusion_type: 2, details: [ { category: 政治, level: 3, msg: 存在政治内容不合规, word: 法轮功 }, { category: 政治, level: 3, msg: 存在政治内容不合规, word: 邪教 } ], violations: [法轮功, 邪教], violation_categories: [政治], violation_count: 2 } }顶层字段字段类型说明codeint0 表示成功非 0 为错误码msgstring状态描述request_idstring唯一请求 ID可用于日志排查dataobject审核结果数据data 对象字段字段类型说明textstring原始请求文本text_lengthint文本长度字符数is_compliantbooltrue 表示完全合规is_suspectedbooltrue 表示疑似违规需人工复核conclusionstring结论描述「合规」「不合规」「疑似」conclusion_typeint1合规2不合规3疑似detailsarray详细命中信息每个元素包含category、level、msg、wordviolationsarray命中违规词去重后的列表violation_categoriesarray命中类别去重后的列表violation_countint总违规条数按命中词去重前计数三态结论is_complianttrue放行is_compliantfalse is_suspectedfalse拒绝is_suspectedtrue进入人工队列。常见错误处理状态码错误场景排查建议400请求体格式错误、text为空或超过 5000 字符检查 JSON 格式确保 1 ≤ len(text) ≤ 5000401API Key 格式错误或过期确认Authorization头以Bearer开头且密钥有效403匿名调用超出每日限制或 API Key 权限不足切换为有效 API Key 或等待额度重置429超过 QPS 5/s降低请求频率加入退避重试逻辑5xx服务端内部错误重试请求若持续发生请联系技术支持工程化注意事项1. 线程安全与并发控制使用Semaphore或RateLimiter限制每秒请求数 ≤ 5批量文本建议按 5 个/秒的速率依次发送避免瞬时超限2. 重试策略对429和5xx错误采用指数退避如 1s、2s、4s最多重试 3 次3. 文本长度预处理前端提交前先校验长度超长文本做截断或分片注意分片可能破坏语义后端应再次校验防止绕过前端限制4. 隐私日志处理接口本身设计已保证缓存 key 为原文哈希、错误日志不记录文本业务方也应避免在应用日志中打印text原文仅记录request_id和结论5. 疑似结果的人工流转对is_suspectedtrue的文本生成工单进入人工审核队列设计人工审核结果回调机制反向异步更新数据库审核状态6. 监控与告警监控429出现频率及时调整客户端限流参数监控5xx比例超过阈值触发告警记录violation_rate违规文本占比用于业务内容安全趋势分析参考文档接口原始文档https://apizero.cn/aidocs/text-censor/raw.md文档页面https://apizero.cn/aidocs/text-censor
企业数字化 ERP 产品动态
相关推荐
学术开题导航仪:AI助力研究选题与文献调研 1. 项目背景与核心价值作为一名在学术写作领域深耕多年的研究者,我深知选题阶段是大多数研究者最痛苦的"死亡谷"。每当面对空白文档时,那种"万事开头难"的焦虑感会消耗研究者50%以上的精力。传统解决方案存在三个致命缺陷࿱… · 2026/11/22 10:01:39
金融舆情监测系统:实时情感分析与交易决策 1. 项目背景与核心价值这个项目本质上是一个面向金融从业者的实时舆情监测系统。我去年在华尔街某对冲基金实习时,亲眼看到交易员们如何在凌晨4点盯着Bloomberg终端和路透社新闻推送做决策。那些手动标注新闻情绪的日子早就该被淘汰了——这就是为什么我们要构建这个… · 2026/11/2 0:16:21
Meta定制AMD MI400 AI芯片:技术解析与开发者影响 最近AI圈有个值得关注的消息:Meta正在与AMD深度合作,定制专为AI工作负载设计的MI400系列芯片。这不仅仅是又一款新硬件的发布,而是标志着科技巨头在AI算力战略上的重要转变——从依赖通用GPU转向定制化专用芯片。 如果你正在为AI项目选择硬件… · 2026/9/20 1:50:41
榆林防爆电工证试题怎么查?网上查询别走弯路,别被中介坑了 榆林防爆电工证试题怎么查?网上查询别走弯路,别被中介坑了 不知道去哪报名怕被中介坑?榆林防爆电工证试题网上查不到,找培训机构又怕被坑,这种情况你不是一个人。我曾经也因为信息不对称,差点被一个中介骗了报名费,还浪费了大把时间。… · 2026/11/22 10:01:10
社评高级电工证怎么考,上岗必备全流程避坑指南 社评高级电工证怎么考,上岗必备全流程避坑指南 怕考不过白交培训费?你不是一个人。每年都有人因为没搞清楚流程,花了钱还拿不到证,耽误了工作机会。 社评高级电工证怎么考 ,这事儿说白了就是“ 上岗必备… · 2026/11/22 10:01:10
技能兴潍电工证怎么考通过率揭秘 帮你避开这些坑 技能兴潍电工证怎么考通过率揭秘 帮你避开这些坑 你现在连电工证都没拿到,连面试机会都没,找工作卡在第一步。技能兴潍电工证怎么考?这几乎是所有想进工地、进工厂、进电气相关岗位的人绕不过的坎。而最让人头疼的是,很多人不知道怎么考、怎么准备,更别… · 2026/11/22 10:01:10
蔡甸区电工证在哪办理怎么查电子证书别再走弯路 蔡甸区电工证在哪办理怎么查电子证书别再走弯路 证书过期了不知道怎么复审延期,结果被单位辞退、项目暂停,这事儿在我们这行太常见了。你是不是也遇到过这种情况?别急,今天咱们就来聊聊 蔡甸区电工证在哪办理 ,同时教你如何顺利查到 电子证书… · 2026/11/22 10:01:10
广东省低压电工证教材怎么选?学历不高也能考,上岗必备先看这篇 广东省低压电工证教材怎么选?学历不高也能考,上岗必备先看这篇 你是不是也担心, 学历不高怕报不上名 ?别急,广东省低压电工证教材虽然是上岗必备的敲门砖,但其实它并没有想象中那么难。只要选对教材、报对机构,哪怕你只有初中学历,也能顺利考下低压… · 2026/11/22 10:00:09
平价的电工证查询保姆级教程:别被中介坑,一步步教你搞定 平价的电工证查询保姆级教程:别被中介坑,一步步教你搞定 你是不是也经常在网上看到“平价的电工证查询”这样的关键词,但又不知道去哪报名,怕被中介坑?特别是像你这样的平顶山学员,既想考个正规电工证,又怕花冤枉钱走弯路。别担心,这篇保姆级教程就是… · 2026/11/22 0:00:42
麻阳考电工证在哪里考内部消息你知道吗 麻阳考电工证在哪里考内部消息你知道吗 不知道去哪报名怕被中介坑, 内部消息 告诉你,麻阳考电工证不一定要去外地,本地其实也有正规渠道,但很多人因为不了解流程和资质,反而被坑了钱还考不到证。今天我就从一个干了这么多年特种作业培训的“老江湖”角… · 2026/11/22 0:00:43
揭阳普宁电工证换证怎么操作?良心建议帮你理清流程 揭阳普宁电工证换证怎么操作?良心建议帮你理清流程 之前考的证在外省能不能转过来?这是很多已经在外地工作、现在想回揭阳普宁发展的电工朋友最关心的问题。如果你也是其中之一,那这篇文章就是为你们量身定制的,从换证流程到避坑建议,良心建议全给你讲透… · 2026/11/22 0:00:43
平价的电工证查询保姆级教程:别被中介坑,一步步教你搞定 平价的电工证查询保姆级教程:别被中介坑,一步步教你搞定 你是不是也经常在网上看到“平价的电工证查询”这样的关键词,但又不知道去哪报名,怕被中介坑?特别是像你这样的平顶山学员,既想考个正规电工证,又怕花冤枉钱走弯路。别担心,这篇保姆级教程就是… · 2026/11/22 0:00:42
麻阳考电工证在哪里考内部消息你知道吗 麻阳考电工证在哪里考内部消息你知道吗 不知道去哪报名怕被中介坑, 内部消息 告诉你,麻阳考电工证不一定要去外地,本地其实也有正规渠道,但很多人因为不了解流程和资质,反而被坑了钱还考不到证。今天我就从一个干了这么多年特种作业培训的“老江湖”角… · 2026/11/22 0:00:43
揭阳普宁电工证换证怎么操作?良心建议帮你理清流程 揭阳普宁电工证换证怎么操作?良心建议帮你理清流程 之前考的证在外省能不能转过来?这是很多已经在外地工作、现在想回揭阳普宁发展的电工朋友最关心的问题。如果你也是其中之一,那这篇文章就是为你们量身定制的,从换证流程到避坑建议,良心建议全给你讲透… · 2026/11/22 0:00:43
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/21 15:19:37
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/21 15:19:30
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/21 15:19:32