朱雀AI检测API接口说明 | 开发者如何集成免费检测功能

2025-03-05| 2332 阅读

🛠️ 朱雀 AI 检测 API 接口基本信息


朱雀 AI 检测 API 是为开发者提供的一套用于集成文本 AI 检测功能的接口服务。通过这个接口,开发者可以将朱雀的 AI 内容识别能力嵌入到自己的应用、网站或工具中,快速实现对文本是否为 AI 生成的检测功能。目前这个接口提供免费额度,对于中小开发者来说相当友好。

接口的基础信息得先弄清楚。接口地址是固定的,目前官方给出的正式地址是https://api.diwuai.com/zhuque/detect,测试环境地址是https://test.api.diwuai.com/zhuque/detect,开发时可以先在测试环境调试,没问题了再切换到正式环境。

请求方式只能用 POST,这一点要记牢。不管是网页端还是移动端集成,都得用 POST 方法发送请求。Content-Type 固定为application/json,也就是说发送的数据必须是 JSON 格式,其他格式会直接返回错误。

认证方式采用 apiKey 验证。开发者需要先在朱雀 AI 平台注册账号,在控制台创建应用后就能获取专属的 apiKey。这个 apiKey 是调用接口的关键,相当于开发者的身份凭证,必须妥善保管,不能泄露给第三方。

📝 接口调用核心参数说明


调用接口时,有些参数是必须传的,有些是可选的。咱们先看必填参数,这几个少了肯定调不通。

apiKey 不用说,字符串类型,就是前面提到的从控制台获取的密钥。每次请求都得带上,接口会通过这个验证开发者身份和权限。

text 也是必填的,字符串类型,就是需要检测的文本内容。这里有个限制,单次检测的文本长度不能超过 10000 个字符,超过的话得自己做截断处理,或者分多次调用。

可选参数里,model 比较常用,字符串类型,默认值是default。朱雀提供了不同的检测模型,比如针对自媒体文章的media模型,针对学术论文的academic模型。如果对检测精度有特定需求,可以指定对应的模型,不填就用默认模型。

format 是返回数据的格式,可选jsonxml,默认是json。大多数开发者应该都会选 json,处理起来更方便,除非系统有特殊要求才用 xml。

还有个callback参数,字符串类型,主要用于异步回调场景。如果设置了这个参数,接口处理完成后会把结果发送到对应的回调地址,适合处理大批量检测的情况。

🔍 接口返回数据格式与解析


接口返回的数据结构比较清晰,不管用哪种格式,核心字段都一样。咱们以默认的 json 格式为例来说说。

返回的根节点里,code 是状态码。200 表示请求成功,这是大家最想看到的。如果是400,说明请求参数有问题,得检查是不是漏了必填项,或者格式不对。401 通常是 apiKey 错误或者过期了,这时候要去控制台看看密钥是不是有效。500 就是服务器内部错误,这种情况比较少见,一般等一会儿再试就行。

msg 字段是状态描述,成功的时候会显示 “success”,失败的时候会给出具体原因,比如 “text 参数不能为空”、“apiKey 无效” 之类的,调试的时候看这个能快速定位问题。

data 字段里包含了具体的检测结果,这才是开发者最关心的。aiProbability 是个百分比数值,范围 0-100,表示文本是 AI 生成的概率。比如返回 85,就说明有 85% 的可能是 AI 写的。

detectResult 是检测结论,字符串类型,可能的值有 “ai-generated”(AI 生成)、“human-written”(人工撰写)、“mixed”(混合内容)。这个结论是根据aiProbability判断的,一般来说超过 70% 会判定为 AI 生成,低于 30% 是人工,中间的就是混合。

detail 字段是详细分析,里面有分段落的检测结果,每个段落都有对应的 AI 概率。如果需要更精细的处理,这个字段能派上用场。

🚀 开发者集成步骤详解


集成步骤其实不复杂,分几步走就行,不管是前端还是后端开发,照着做基本都能搞定。

第一步,注册并获取 apiKey。先打开朱雀 AI 的官网(https://www.diwuai.com),注册账号后登录控制台,找到 “API 服务” 板块,点击 “创建应用”,填个应用名称,选 “AI 检测” 服务,提交后就能在应用详情里看到 apiKey 了。记得把这个密钥存好,后面调用必须用。

第二步,根据开发语言写请求代码。这里举几个常用语言的例子。比如 Python,用 requests 库发送 POST 请求就行:

python
import requests
import json

url = "https://api.diwuai.com/zhuque/detect"
headers = {"Content-Type": "application/json"}
data = {
    "apiKey": "你的apiKey",
    "text": "需要检测的文本内容",
    "model": "default"
}
response = requests.post(url, headers=headers, data=json.dumps(data))
print(response.json())

如果是 JavaScript(Node.js),可以用 axios:

javascript
const axios = require('axios');

async function detectText() {
  try {
    const response = await axios.post('https://api.diwuai.com/zhuque/detect', {
      apiKey: '你的apiKey',
      text: '需要检测的文本内容',
      model: 'default'
    }, {
      headers: { 'Content-Type': 'application/json' }
    });
    console.log(response.data);
  } catch (error) {
    console.error(error);
  }
}

第三步,处理返回结果。拿到接口返回的数据后,先判断code是不是 200。如果是,就从data里提取aiProbabilitydetectResult,根据业务需求展示给用户,比如在页面上显示 “该文本 AI 生成概率为 XX%”。如果不是 200,就根据msg提示用户错误信息,比如 “检测失败,请检查 apiKey 是否正确”。

第四步,测试和调试。先用测试环境接口调试,把各种情况都试试,比如文本太长、apiKey 错误、参数缺失这些情况,看看返回的错误信息对不对。确认没问题了,再切换到正式环境,上线前最好再做一次完整测试。

⚠️ 接口使用注意事项与常见问题


使用接口的时候,有些地方得多注意,不然可能会出问题,影响功能正常使用。

apiKey的安全很重要。绝对不能把 apiKey 明文写在前端代码里,比如 JavaScript 文件,很容易被别人扒走。正确的做法是,前端把要检测的文本发送到自己的后端服务器,由后端服务器带上 apiKey 调用朱雀的接口,这样能保证密钥安全。

调用频率有限制。免费用户每分钟最多调用 30 次,每小时不超过 500 次,每天 10000 次。如果超过这个频率,接口会返回 429 错误,提示 “请求过于频繁”。要是业务需求比较大,得联系官方申请提高额度,或者自己做请求队列,控制调用速度。

文本长度别超标。前面说了单次检测不能超过 10000 字符,大概就是 2000 个汉字左右。如果文本太长,比如一篇长文章,最好分段处理,每段控制在 8000 字符以内,检测完再合并结果。

处理错误情况要全面。除了 429,还有可能遇到 401(密钥无效)、400(参数错)、500(服务器问题)。代码里得针对这些状态码做不同处理,比如 401 的时候提示用户重新获取 apiKey,500 的时候让用户稍后再试。

💰 免费额度与功能扩展说明


朱雀 AI 检测 API 的免费额度对中小开发者来说很够用。注册后默认就是免费用户,每天有 10000 次调用额度,单次文本 10000 字符限制,支持默认模型和基础检测功能。一般的个人博客、小工具集成,这个额度完全能满足需求。

如果免费额度不够用,或者需要更高级的功能,可以升级到付费版。付费版分几个档次,最低的月度套餐是 99 元,每天 50000 次调用,支持所有检测模型,还能获取更详细的检测报告,包括句子级别的 AI 概率分析。企业用户可以定制套餐,有专属客服和技术支持。

功能扩展方面,付费用户可以使用批量检测接口,一次最多提交 100 条文本,大大提高效率。还有异步检测模式,适合处理大量文本,提交后接口会返回一个任务 ID,开发者可以通过任务 ID 查询检测进度和结果。

另外,朱雀还提供了 SDK,支持 Python、Java、PHP 等多种语言,集成起来更方便,不用自己处理 HTTP 请求细节。SDK 里还有错误处理、重试机制等功能,能减少开发工作量。

【该文章由diwuai.com第五 ai 创作,第五 AI - 高质量公众号、头条号等自媒体文章创作平台 | 降 AI 味 + AI 检测 + 全网热搜爆文库
🔗立即免费注册 开始体验工具箱 - 朱雀 AI 味降低到 0%- 降 AI 去 AI 味

分享到:

相关文章

创作资讯2025-05-21

aigc 检测有必要吗?学术诚信与 AI 生成内容风险评估

话说到 AIGC 检测有没有必要,这事儿在学术界可真是掀起了不小的波澜。如今 AI 生成内容的技术发展得那叫一个快,像 ChatGPT 这类工具,能轻轻松松写出论文、报告,甚至是学术文章。这就让人犯难

第五AI
创作资讯2025-03-23

核心观点人工撰写 AI 优化步骤:手机端避免高检测率方法

现在很多人写东西都爱用 AI,但最怕的就是被检测出来 —— 尤其是在手机端写稿,总担心哪步没做好,AI 味儿太重被平台判违规。其实只要掌握 “核心观点人工写,AI 只做优化” 的逻辑,再注意几个细节,

第五AI
创作资讯2025-04-24

第五 AI 与传统工具对比分析:2025 最新自媒体内容创作解决方案

自媒体创作领域的技术革新速度之快,常常让人应接不暇。2025 年,第五 AI 的横空出世,彻底打破了传统工具的创作边界。这款集智能生成、多模态处理、SEO 优化于一体的平台,正在重新定义自媒体内容生产

第五AI
创作资讯2025-04-26

如何做公众号差异化定位?在红海领域中找到你的蓝海市场

现在打开公众号后台,是不是总觉得心慌?同类账号一刷一大把,自己发的内容阅读量总在两位数徘徊。其实不是你写得不好,而是没找到那个 “非你不可” 的定位。在红海市场里拼杀,差异化才是破局的唯一出路。​🎯

第五AI
推荐2025-11-07

公众号注册的“蝴蝶效应”:一个选择,可能影响未来三年的运营 - 前沿AIGC资讯

你可能觉得公众号注册就是填几个信息的事,殊不知,这里面的每个选择都像蝴蝶扇动翅膀,未来三年的运营轨迹可能就被悄悄改变了。很多人刚开始没当回事,等到后面想调整,才发现处处受限,那叫一个后悔。今天就跟你好好聊聊,注册时那些看似不起眼的选择,到底能给未来的运营带来多大影响。​📌账号类型选不对,三年运营路难

第五AI
推荐2025-11-07

AI写作如何进行事实核查?确保头条文章信息准确,避免误导读者 - AI创作资讯

上周帮同事核查一篇AI写的行业报告,发现里面把2023年的用户增长率写成了2025年的预测数据。更离谱的是,引用的政策文件号都是错的。现在AI生成内容速度快是快,但这种硬伤要是直接发出去,读者信了才真叫坑人。今天就掰开揉碎了说,AI写作怎么做好事实核查,别让你的头条文章变成 误导重灾区 。​📌AI写

第五AI
推荐2025-11-07

10w+阅读量爆文案例拆解分析:高手都从这5个维度入手 - AI创作资讯

🎯维度一:选题像打靶,靶心必须是「用户情绪储蓄罐」做内容的都清楚,10w+爆文的第一步不是写,是选。选题选不对,后面写得再好都是白搭。高手选选题,就像往用户的「情绪储蓄罐」里投硬币,投对了立刻就能听到回响。怎么判断选题有没有击中情绪?看三个指标:是不是高频讨论的「街头话题」?是不是藏在心里没说的「抽

第五AI
推荐2025-11-07

135编辑器会员值得买吗?它的AI模板库和秀米H5比哪个更丰富? - AI创作资讯

📌135编辑器会员值不值得买?AI模板库和秀米H5谁更胜一筹?🔍135编辑器会员的核心价值解析企业级商用保障与效率提升135编辑器的企业会员堪称新媒体运营的「合规保险箱」。根据实际案例,某团队通过企业会员节省了大量设计费用,完成多篇内容创作,单篇成本从千元降至百元内。这得益于其海量正版模板和素材库,

第五AI
推荐2025-11-07

新公众号被限流怎么办?粉丝增长影响分析及 2025 恢复指南 - AI创作资讯

新公众号被限流怎么办?粉丝增长影响分析及2025恢复指南🔍新公众号限流的核心原因解析新公众号被限流,往往是多个因素叠加的结果。根据2025年最新数据,超过70%的限流案例与内容质量直接相关。比如,有些新手喜欢用“震惊体”标题,像“惊!某公众号三天涨粉十万”,这类标题在2025年的算法里已经被明确标记

第五AI
推荐2025-11-07

AI内容重复率太高怎么办?掌握这些技巧轻松通过AIGC检测 - AI创作资讯

⚠️AI内容重复率高的3大核心原因现在用AI写东西的人越来越多,但很多人都会遇到同一个问题——重复率太高。明明是自己用工具生成的内容,一检测却显示和网上某些文章高度相似,这到底是为什么?最主要的原因是AI训练数据的重叠性。不管是ChatGPT还是国内的大模型,训练数据来源其实大同小异,都是爬取的互联

第五AI
推荐2025-11-07

135编辑器让排版更简单 | 专为公众号运营者设计的效率工具 - AI创作资讯

🌟135编辑器:公众号运营者的效率革命做公众号运营的朋友都知道,排版是个费时费力的活。一篇文章从内容到排版,没几个小时根本搞不定。不过现在好了,135编辑器的出现,彻底改变了这一现状。135编辑器是提子科技旗下的在线图文排版工具,2014年上线至今,已经成为国内新媒体运营的主流工具之一。它的功能非常

第五AI
推荐2025-11-07

用对prompt指令词,AI内容的原创度能有多高?实测效果惊人 - 前沿AIGC资讯

现在做内容的人几乎都离不开AI,但最头疼的就是原创度。平台检测一严格,那些模板化的AI文很容易被打回,甚至判定为“非原创”。但你知道吗?同样是用AI写东西,换个prompt指令词,原创度能差出天壤之别。我最近拿不同的prompt测了好几次,结果真的吓一跳——好的指令能让AI内容原创度直接从“及格线”

第五AI
推荐2025-11-07

2025 论文降 aigc 的指令指南:疑问词解答与高频技巧汇总 - 前沿AIGC资讯

🔍2025论文降AIGC指令指南:疑问词解答与高频技巧汇总🚀一、为啥论文会被判定AIGC超标?现在的检测工具可精了,它们会从好几个方面来判断。比如说,要是句子结构太工整,像“首先……其次……最后”这种对称的句式,就容易被盯上。还有,要是老是用“综上所述”“基于此”这类高频学术词,也会被当成AI生成的

第五AI
推荐2025-11-07

朱雀 AI 检测抗绕过方法:2025 最新技术解析与实测对比 - AI创作资讯

🔍朱雀AI检测抗绕过方法:2025最新技术解析与实测对比🔍在AI生成内容泛滥的今天,腾讯朱雀AI检测系统凭借其多模态分析技术和百万级数据训练,成为行业标杆。但道高一尺魔高一丈,对抗者们正通过各种技术手段挑战其检测边界。本文将深入解析2025年最新的抗绕过方法,并结合实测数据对比效果。🛠️技术架构解析

第五AI