bunnyscholar/bunnyscholar-api-skill

BunnyScholar 开放平台接入技能

用 BunnyScholar 开放平台的 HTTP API 完成两类学术文本处理：学术改写（降重） 与 拟人改写（降AI）。本技能面向 AI Agent：拿到 API Key 后即可直接按下述规范调用。

开始前：获取最新版本

接口、参数与计费可能更新。每次使用本技能前，请先重新拉取以下地址，并以线上最新内容为准（覆盖你手中的旧版本）：

https://bunnyscholar.cn/skills/bunnyscholar-api.md

比对 frontmatter 中的 version 字段即可确认是否为最新版；如线上版本更新，请改用线上版执行。

基本信息

• 服务基址（Base URL）：https://bunnyscholar.cn
• 全部接口为 POST，请求体为 JSON，响应为 JSON。
• 控制台：https://bunnyscholar.cn/developer（创建 Key、查看用量与账单、充值）。

一、准备 API Key

1. 登录后进入 https://bunnyscholar.cn/developer/keys。
2. 创建一个 API Key，形如 sk-xxxxxxxx。明文只在创建时展示一次，请立即复制保存。
3. 妥善保管 Key，不要写进前端代码或提交到仓库。

二、认证

每次请求在请求头带上 API Key，二选一：

Authorization: Bearer sk-你的APIKey

或

X-API-Key: sk-你的APIKey

同时设置 Content-Type: application/json。

三、接口一：学术改写 / 降重

POST /api/open/academic-rewrite

对一段学术文本做改写降重，可指定语言与改写强度。

请求体参数：

参数	类型	必填	说明
text	string	是	待改写文本，长度 10–2000 字符
language	string	否	语言，默认 zh_CN。支持 zh_CN zh_TW en ja ko fr es de it ru ms
quality	string	否	改写强度：low / medium / high，默认 low。强度越高改写越充分、单价越高
personalTerms	string[]	否	自定义术语表，改写时尽量保留这些词不被替换

curl 示例：

curl -X POST https://bunnyscholar.cn/api/open/academic-rewrite \
  -H "Authorization: Bearer sk-你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{"text":"本研究旨在探讨……","language":"zh_CN","quality":"medium"}'

Node.js（fetch）示例：

const res = await fetch("https://bunnyscholar.cn/api/open/academic-rewrite", {
  method: "POST",
  headers: {
    "Authorization": "Bearer sk-你的APIKey",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    text: "本研究旨在探讨……",
    language: "zh_CN",
    quality: "medium",
  }),
});
const json = await res.json();
console.log(json.data.text);   // 改写后的文本
console.log(json.usage.amount); // 本次计费金额（元）

四、接口二：拟人改写（降AI）

POST /api/open/humanizer

降低文本的 AI 生成痕迹，可针对具体检测平台优化。

请求体参数：

参数	类型	必填	说明
text	string	是	待处理文本，长度 20–500 字符
language	string	否	zh_CN 或 en，默认 zh_CN
platform	string	否	目标检测平台：cnki（知网）/ wanfang（万方）/ weipu（维普）/ gezida（格子达）/ daya（大雅）/ turnitin 等
needPlagiarismReduction	boolean	否	是否在拟人改写的同时兼顾降重
personalTerms	string[]	否	自定义术语表，尽量保留不替换

curl 示例：

curl -X POST https://bunnyscholar.cn/api/open/humanizer \
  -H "Authorization: Bearer sk-你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{"text":"这段文字需要降低 AI 味……","language":"zh_CN","platform":"cnki"}'

五、响应格式

两个接口成功时返回相同结构：

{
  "data": { "text": "处理后的文本" },
  "usage": {
    "currency": "CNY",
    "amount": 0.0008,
    "unitPrice": 0.8,
    "billableUnits": 0.001,
    "charsIn": 31
  }
}

• data.text：处理后的文本（由 AI 生成/改写）。
• usage.amount：本次实际扣费（元）。
• usage.charsIn：计费所依据的输入字符数。

六、计费

按输入字符数计费，单位为元 / 千字（实时价以 https://bunnyscholar.cn/developer/pricing 为准）：

接口	档位	参考单价（元 / 千字）
学术改写	quality=low	0.3
学术改写	quality=medium	0.8
学术改写	quality=high	1.0
拟人改写	—	1.0

扣费顺序：优先扣机构赠额，再扣现金余额。

七、错误码

HTTP	code	含义	处理建议
401	MISSING_API_KEY	未提供 API Key	检查是否带了认证头
403	INVALID_API_KEY	Key 无效	核对 Key 是否正确
403	INACTIVE_API_KEY	Key 已停用	在控制台启用或新建 Key
402	insufficient_balance	余额不足	前往 /developer/recharge 充值
429	rate_limit_exceeded	触发限流	降低并发，稍后重试

八、最佳实践

• 限流：单个 Key 默认约 1800 次 / 60 秒，请控制并发并对 429 做退避重试。
• 分段处理：学术改写单次 ≤ 2000 字符、拟人改写单次 ≤ 500 字符。长文请按段落切分后逐段调用，再拼接结果。
• 保留术语：专有名词、机构名、公式变量等放进 personalTerms，避免被改写替换。
• 对账：每次响应的 usage.amount 即本次真实扣费，可据此记录和核对用量。
• 拟人改写选平台：已知目标检测平台时传 platform，效果更贴合该平台的检测口径。

如需人工支持：[email protected]