接口文档

API 运行正常

API 概览

BunnyScholar 开放平台提供 学术改写(降重)（Academic Rewrite） 与 拟人改写(降AI率)（Humanizer） 两大能力，所有请求均通过 HTTPS、按输入字符计费。您可以在「用量信息 / 账单记录」页面实时查看余额与消费。

Base URL

https://bunnyscholar.cn

鉴权方式

Authorization: Bearer <API_KEY> 或 X-API-Key

Content-Type

application/json; charset=utf-8

快速开始

  1. 在开放平台的「API Keys」页面创建并保存一个sk_xxx形式的密钥。
  2. 在「充值」页面使用微信扫码为账户充值，余额不足时请求会返回 insufficient_balance。
  3. 使用下方任一接口示例发起请求，携带 Authorization 头和 JSON 请求体。

接口定义

Academic Rewrite

POST /api/open/academic-rewrite

根据质量档位选择不同模型，返回单条优化后的学术表述。

字段类型必填说明
textstring必填待改写的原文，支持 10~2000 字符（按实际字符计费）
languagestring可选输出语言，默认 zh_CN，可选范围见支持语言表
qualitystring可选low / medium / high，对应不同效果档位与单价，默认 low
personalTermsstring[]可选术语白名单，保留专有名词；示例：["BunnyScholar", "AI写作"]

请求示例（curl）

curl -X POST https://bunnyscholar.cn/api/open/academic-rewrite \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "本研究旨在探索高校学生在AI写作工具辅助下的写作行为变化。",
    "language": "zh_CN",
    "quality": "medium"
  }'

响应示例（截断）

{
  "data": {
    "text": "本研究聚焦高校学生在AI写作支持环境中的写作行为演化。"
  },
  "usage": {
    "currency": "CNY",
    "amount": 0.0008,
    "unitPrice": 0.8,
    "billableUnits": 0.001,
    "charsIn": 31
  }
}

Humanizer

POST /api/open/humanizer

通过多模型融合降低 AI 检测概率，可选保留术语与轻量降重。

字段类型必填说明
textstring必填待拟人化的原文，中文支持 20~500 字符，英文支持 20~400 字符
languagestring可选目标语言，当前支持 zh_CN 与 en，默认 zh_CN
personalTermsstring[]可选术语白名单，保留专有名词；示例：["BunnyScholar", "AI"]
needPlagiarismReductionboolean可选是否同时执行轻量降重，默认 false。开启会略微延长响应时间。
platformstring可选目标检测平台，默认 zh_CN→cnki / en→turnitin，可选值包含 cnki、weipu、gezida、turnitin、gptzero

请求示例（Node.js fetch）

const response = await fetch("https://bunnyscholar.cn/api/open/humanizer", {
  method: "POST",
  headers: {
    "Authorization": "Bearer sk_live_xxx",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    text: "AI generated content is increasingly easy to detect.",
    language: "en",
    personalTerms: ["AI", "BunnyScholar"],
    needPlagiarismReduction: false
  })
});
const result = await response.json();

响应示例

{
  "data": {
    "text": "As AI writing becomes widespread, detection tools are also improving."
  },
  "usage": {
    "currency": "CNY",
    "amount": 0.002,
    "unitPrice": 2,
    "billableUnits": 0.001,
    "charsIn": 22
  }
}
响应字段类型说明
data.textstring模型返回的改写结果文本
usage.amountnumber本次计费金额（人民币），按实际字符精确计算
usage.unitPricenumber当前语言/质量档的单价（元/千字）
usage.billableUnitsnumber本次计费的单位数（千字为单位，按四舍五入到小数点后 4 位）
usage.charsInnumber请求实际输入的字符数
usage.currencystring币种代码，固定返回 CNY

在线调试（Playground）

使用真实 API Key 直接调试线上接口。填写完成后点击「发送请求」，响应结果会实时展示。调试请求会计费，请确认余额充足。

学术改写(降重)和拟人改写(降AI率)都会保留这些术语原样输出。

温馨提示：调试请求会真实计费

错误码

状态码错误码说明
401MISSING_API_KEYAuthorization 头或 X-API-Key 头缺失
403INVALID_API_KEYAPI Key 不存在或已被删除
403INACTIVE_API_KEYAPI Key 已禁用，请在控制台启用后重试
400text_required请求体缺少 text 字段或内容为空
400text_too_short输入字符少于最小值（学术改写(降重) 10，拟人改写(降AI率) 20）
400text_too_long输入字符超过上限（学术改写(降重) 2000，拟人改写(降AI率) 中文 500 / 英文 400）
400unsupported_languagelanguage 不在允许列表内，响应会附带 supportedLanguages
400invalid_qualityquality 仅允许 low / medium / high（仅学术改写(降重)）
402insufficient_balance账户余额不足，需先充值 API 余额
500billing_config_error计费配置异常，请联系技术支持
500internal_error服务内部错误，可稍后重试或联系技术支持

出现 internal_error 或 billing_config_error 时，请记录请求时间、body 以及响应并联系技术支持（support@bunnyscholar.com）。

建议为每个业务环境拆分独立 API Key，并开启调用监控。若需扩展限流、白名单或自定义计费方案，请联系企业顾问。