📘 Nanke API 文档

统一的 AI 模型接口网关 · 一个 API 连接全球顶尖模型

Nanke API 是一个 AI 模型聚合与中转平台，通过统一的 API 网关连接全球主流大模型。你只需要一个 API Key，就能调用 Claude、GPT、Gemini、DeepSeek 等 33+ 款模型，无需单独注册、无需海外支付、无需担心网络问题。

💡 你能在这里找到什么

快速完成账号注册与 API Key 创建
查看标准接口请求格式和示例代码
了解 SillyTavern、Cline 等工具的接入方法
常见错误及排查方法

🚀 推荐阅读顺序 如果你是第一次使用，建议先阅读快速开始，跑通一次完整请求，再继续做更细的配置。

⚡ 快速开始

5 分钟跑通你的第一次 API 调用。

第 1 步：注册账号

访问 https://nanke.fun/register 完成注册。新用户自动获得 100 万 token 免费体验额度。

第 2 步：获取 API Key

登录后进入控制台，在「API Keys」页面创建你的专属密钥。

第 3 步：发起第一次请求

用 curl 测试你的 API Key 是否生效：

curl https://nanke.fun/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-5.4",
    "messages": [
      {"role": "user", "content": "你好，请简单介绍一下你自己"}
    ]
  }'

✅ 成功标志 如果返回包含 choices 字段的 JSON 响应，说明接入成功！

🔑 认证与鉴权

Nanke API 使用 Bearer Token 方式进行身份认证。

API 基础信息

Base URL	`https://nanke.fun/v1`
认证方式	`Authorization: Bearer YOUR_API_KEY`
请求格式	`application/json`

API Key 安全建议

不要将 API Key 硬编码在客户端代码中
定期在控制台轮换 API Key
如发现 Key 泄露，立即在控制台删除并重新生成

🧠 模型列表

Nanke API 当前支持 33+ 款模型，覆盖全球主流大模型。

角色扮演主力（RP 优化）

模型	定位	描述
`nousresearch/hermes-3-llama-3.1-70b`	RP 旗舰	开源 RP 标杆，文笔自然流畅，几乎不拒答
`sao10k/l3.3-euryale-70b`	RP 经典款	创意丰富，角色一致性高
`anthracite-org/magnum-v4-72b`	长文本 RP	72B 参数，长篇角色扮演一致性极强

长文本专用（1M 上下文）

模型	定位	描述
`xiaomi/mimo-v2.5`	长文本(1M)	小米出品，原生多模态，1M 上下文
`minimax/minimax-m3`	长文本(1M)	稀疏注意力机制，1M 上下文成本极低
`z-ai/glm-5.2`	长文本(1M)	1.6T MoE 架构，编程与工具调用强

推理 / 编程

模型	定位	描述
`mistralai/mistral-large-2512`	推理旗舰	欧洲最强开源模型，逻辑推理突出
`mistralai/codestral-2508`	编程专用	代码生成与 Debug 专用

📌 完整模型列表 访问 https://nanke.fun/models 查看全部 33+ 款模型及实时价格。

💰 定价说明

Nanke API 采用按量付费模式，价格远低于官方直连。

系列	输入价 (¥/M)	输出价 (¥/M)	对比官方
Claude 系列	0.79 - 259.99	1.69 - 1299.99	官方价 3.8 - 4.4 折
Gemini 系列	8.69 - 34.79	51.99 - 207.99	官方价 3.4 折
GPT 系列	—	—	官方价 4.2 折
开源 RP 模型	0.15 - 0.94	0.30 - 1.89	极致性价比

🎁 新用户福利 注册即送 100 万 token 免费体验额度，无需付费即可测试全部模型。

🎭 SillyTavern 接入指南

SillyTavern 是 RP 玩家最常用的前端工具，Nanke API 完美兼容。

配置步骤

打开 SillyTavern，进入 API Connections 设置
选择 OpenAI Compatible 作为 API Provider
填写以下配置：

API Provider: OpenAI Compatible
Base URL: https://nanke.fun/v1
API Key: 你的 API Key
Model ID: 选择你想用的模型（如 nousresearch/hermes-3-llama-3.1-70b）

💡 提示 模型列表会动态同步，下拉菜单中如有未显示的模型，可手动输入模型 ID。

🧩 Cline / VS Code 接入指南

Cline 是 VS Code 中最流行的 AI 编程助手插件，Nanke API 同样完美兼容。

配置步骤

在 VS Code 中安装 Cline 插件
打开 Cline 设置，选择 OpenAI Compatible
填写以下配置：

API Provider: OpenAI Compatible
Base URL: https://nanke.fun/v1
API Key: 你的 API Key
Model ID: 推荐 mistralai/mistral-large-2512 或 mistralai/codestral-2508

⚠️ 注意 Cline 的 System Prompt 较复杂，建议使用推理能力较强的模型（如 Mistral Large 2512）以获得最佳效果。

📡 对话接口

POST /v1/chat/completions

请求参数

参数	类型	必填	说明
`model`	string	✅	模型 ID，见模型列表
`messages`	array	✅	对话消息数组
`temperature`	number	❌	0-2，默认 1.0
`max_tokens`	integer	❌	最大输出 token 数
`stream`	boolean	❌	是否流式输出，默认 false

请求示例

curl https://nanke.fun/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "nousresearch/hermes-3-llama-3.1-70b",
    "messages": [
      {"role": "system", "content": "你是一个乐于助人的助手"},
      {"role": "user", "content": "介绍一下你自己"}
    ],
    "temperature": 0.7,
    "max_tokens": 500,
    "stream": false
  }'

❌ 错误码

HTTP 状态码	说明	处理建议
400	请求参数错误	检查请求格式和必填字段
401	认证失败	检查 API Key 是否正确
429	请求频率超限	降低请求频率，稍后重试
500	服务器内部错误	稍后重试，如持续出现请联系客服
503	上游模型暂时不可用	模型并发已满，稍后重试或切换其他模型

❓ 常见问题

1. 新用户有免费额度吗？

有。新用户注册自动获得 100 万 token 免费体验额度，可用于测试所有模型。

2. 支持哪些支付方式？

当前支持 支付宝 和 Stripe 支付，微信支付正在接入中。

3. 模型调用速度怎么样？

轻量模型首 token 延迟约 1-3 秒，70B+ 大模型约 3-8 秒。流式输出支持打字机效果。

4. 支持哪些客户端？

支持所有 OpenAI 兼容客户端，包括 SillyTavern、Cline、ChatBox、OpenCat 等。

5. 模型会经常变化吗？

我们会持续增加新模型，旧模型下架会提前 7 天在群内和文档中公告。

📌 还有问题？ 加入用户群 @管理员，或查看完整文档。

📋 更新日志

v3.0 — 2026年7月

接入 Featherless 开源 RP 模型池（7 款 RP 优化模型）
新增 OpenRouter 长文本模型（1M 上下文）
全线降价，部分模型降至官方价 3.4 折
优化并发路由策略，稳定性提升

v2.0 — 2026年6月

正式域名 nanke.fun 启用，HTTPS 全面配置
Cloudflare Worker 反代上线，国内访问更稳定
接入 DeepSeek 映射渠道，覆盖 Claude/Gemini/GPT 系列

v1.0 — 2026年6月

平台正式上线，支持 20+ 款模型
自助充值系统上线