一、概述
朱雀是腾讯面向 AIGC 内容检测的能力，可判断文本或图片是否由 AI 生成。通过 EdgeOne Makers 内置模型统一接入后，你可以直接调用文本检测能力（@makers/zhuque-text）。
注意：说明：
注意：1. 朱雀模型的调用消耗会计入 Makers 平台每月 50 万 token 的免费额度，额度内可直接体验。
注意：2. 当前支持文本检测体验，图片检测体验可前往 朱雀 AI 检测助手页面。
注意：3. 若你需要图片检测能力，或免费额度无法满足业务需要：
二、步骤一：创建 API Key
1. 登录 EdgeOne 控制台。
2. 进入控制台后页面已定位至 Makers – Models – API Key。
3. 单击 创建 API Key，填写名称并确认，创建完成后请妥善保存该 Key。
三、步骤二：调用模型
在 模型与密钥 页面的内置模型列表中可看到 @makers/zhuque-text，标识为内置模型。
请求参数：
| 参数 | 位置 | 类型 | 必填 | 说明 |
| text | Body | string | 是 | 待检测的文本内容 |
| is_merge | Body | bool | 否 | 是否合并段落，默认为 true。设为 false 时，每个段落独立输出置信度 |
curl 示例：
curl -i -X POST "https://ai-gateway.edgeone.link/v1/providers/zhuque-text/classify" \\ -H "Authorization: Bearer $MAKERS_MODELS_KEY" \\ -H "Content-Type: application/json" \\ -d '{ "text": "hello world", "is_merge": true }'
四、Running Environment
Operating System: Ubuntu 24.04.3 LTS / x86_64Runtime Version: GNU bash, version 5.2.21(1)-release (x86_64-pc-linux-gnu)
响应示例：
{ "status": "success", "softmax_confidence": 0.0019, "ratio_confidence": 0, "labels_ratio": {"0": 1, "1": 0, "2": 0}, "segment_labels": [ {"text": "hello world", "label": 0, "conf": 0.0019, "order": 1, "position": [0, 11]} ], "usage": {"total_tokens": 50}, "msg": "", "makers_models_usage": {"total_tokens": 30}}
响应字段说明：
| 字段 | 类型 | 说明 |
| status | string | 推理状态，success 表示成功 |
| labels_ratio | object | 各类型内容占比。"0" 为人工（Human）内容占比，"1" 为 AI 内容占比，"2" 为疑似 AI 内容占比，取值均在 [0, 1] |
| ratio_confidence | float | 整体疑似风险内容占比，越大越可能命中风险 |
| segment_labels | array | 各分段的类型标签及置信度 |
| softmax_confidence | float | 整体置信度，越大越可能命中风险内容 |
| usage.total_tokens | int | 朱雀模型自身的用量统计，与 Makers 免费额度核算无关 |
| msg | string | 错误信息，正常时为空 |
| makers_models_usage.total_tokens | int | 本次调用实际扣减的 Makers 免费额度 token 数，核算免费额度请以此字段为准 |
五、查看模型用量
进入 Makers 概览 页面，在 模型用量数据总览 区域选择 内置模型，可查看用量情况。