AI 文本审核接口（text.moderation）：大模型多标签识别违规内容

这个接口能解决什么问题

text.moderation 把文本风控前置到发布之前。相比关键词黑名单，大模型能理解谐音、拆字、隐喻与上下文，对复杂隐晦的违规表达同样有效；接口返回的是「结论 + 证据」——既有风险等级，也有具体命中的标签与置信度，方便直接写进审核规则，而不是只拿到一个通过 / 拒绝的黑盒结果。

一句话说明

提交一段文本，返回风险等级 + 命中标签 + 置信度 + 处置建议；正常给出审核结论（含未检测出风险）即计费，空文本 / 超长 / 模型不可用不收费。

适用场景

社区发帖 / 评论过滤：发布前自动机审
弹幕与聊天风控
昵称 / 签名审核
电商评价与客服质检
内容平台机审前置

接口规格

接口规格
请求地址	`https://api.xujian.tech/openapi/text/moderation`
请求方式	GET（content 放 Query）或 POST（content 放 JSON body）
鉴权方式	请求头 `X-API-Key`
接口编码	`text.moderation`
收费类型	按次计费（PER_CALL，0.0100 元/次）
计费规则	结论计费：content 为空 / 超长、大模型不可用、模型返回无法解析时失败且不扣费；正常给出结论（含未检测出风险）正常计费
文本长度	单次不超过 1800 个字符
典型耗时	通常 1 ~ 5 秒
典型用途	社区过滤、弹幕风控、昵称审核、客服质检

如何调用

文本含换行、引号等特殊字符时建议用 POST，把请求体存成 body.json 后用 -d @body.json 提交：

cURL（POST）

curl -s -X POST "https://api.xujian.tech/openapi/text/moderation" -H "Content-Type: application/json" -H "X-API-Key: 你的APIKey" -d @body.json

body.json 内容

JSON

{
  "content": "加我微信 xxx666，带你日入过万，内部渠道稳赚不赔"
}

返回示例（命中违规，code = 0）

JSON

{
  "code": 0,
  "msg": "success",
  "data": {
    "riskLevel": "high",
    "labels": [
      { "label": "广告导流", "score": 0.96 },
      { "label": "诈骗", "score": 0.88 }
    ],
    "suggest": "reject",
    "apiCode": "text.moderation",
    "apiName": "AI文本审核服务",
    "chargeType": "PER_CALL",
    "balance": 99.9900,
    "costMs": 1200
  }
}

计费说明

按次计费，0.0100 元/次。采用「结论计费」：content 为空 / 超长、大模型不可用、模型返回无法解析时返回失败，不扣费；正常给出审核结论（包括「未检测出风险」）即计一次费用。

常见问题

风险等级怎么用？ none / low 通常可放行，medium 建议人工复核，high 建议直接拒绝；具体阈值由你的业务规则决定。
文本太长怎么办？ 单次不超过 1800 字符；超长直接返回失败且不收费。
能审图片里的文字吗？ 本接口只处理文本；图片文字需先用 OCR（如 idcard.ocr / vehicle.license）提取后再送审。