零样本分类
POST
/api/v1/moderate/nli需认证基于 mDeBERTa-v3-base-mnli-xnli 模型的零样本文本分类接口。输入一段文本与候选标签,模型返回每个标签的概率分布,支持 100+ 种语言。适用于内容风险预判、意图识别、情感分析等场景。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| text | string | 必填 | 待分类的文本内容 |
| candidate_labels | array<string> | 可选 | 自定义候选标签;不传则使用服务默认 9 类风险标签 |
请求示例
bash
curl -X POST https://api.ogmiao.com/api/v1/moderate/nli \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"text": "免费领取现金大奖,点击链接立即提现",
"candidate_labels": ["诈骗欺诈", "正常内容"]
}'响应示例
JSON
{
"code": 0,
"data": {
"text": "免费领取现金大奖,点击链接立即提现",
"labels": [
{ "label": "诈骗欺诈", "score": 0.5376, "percentage": 53.76 },
{ "label": "正常内容", "score": 0.4624, "percentage": 46.24 }
],
"count": 2,
"duration": 0.218,
"uuid": "f3a2e1c4-5b6d-7e8f-9a0b-1c2d3e4f5a6b"
}
}响应字段说明
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| text | string | 必填 | 原始输入文本 |
| labels | array | 必填 | 标签概率列表(按 score 降序) |
| labels[].label | string | 必填 | 标签名称 |
| labels[].score | number | 必填 | 概率 0-1 |
| labels[].percentage | number | 必填 | 百分比 0-100 |
| count | integer | 必填 | 标签数量 |
| duration | number | 可选 | 推理耗时(秒) |
| uuid | string | 可选 | 请求追踪 ID |
说明:服务未就绪时返回 500 错误(不回退到 DFA),调用方需自行降级;与 /api/v1/moderate(DFA 敏感词)互补,建议两者结合使用。