📘 Nanke API 文档

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

⚡ 快速开始

本指南会带你完成接入 Nanke API 的最短路径，包括注册账号、登录控制台、充值额度、创建 API 令牌，以及发起第一次请求。 快速开始吧 🚀

📡 第一次请求示例

在开始调用前，请先确认下面两项：

• Base URL：https://nanke.fun/v1
• Authorization：Bearer YOUR_API_KEY
• 令牌分组：请使用对应模型分组的 API Key

cURL

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": "你好，请简单介绍一下你自己。"}
    ]
  }'

Python

import requests

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

response = requests.post(url, headers=headers, json=payload, timeout=60)
print(response.status_code)
print(response.json())

Node.js

const response = await fetch("https://nanke.fun/v1/chat/completions", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
  },
  body: JSON.stringify({
    model: "gpt-5.4",
    messages: [{"role": "user", "content": "你好，请简单介绍一下你自己。"}]
  })
});

const result = await response.json();
console.log(result);

🔑 认证与鉴权

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

API 基础信息

API Key 安全建议

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

🛠️ 兼容工具

Nanke API 兼容 OpenAI API 格式，所有支持自定义 Provider 的 AI 工具均可接入。

🧠 模型列表

Nanke API 当前支持 50+ 款模型，覆盖全球主流大模型，持续上新中。

角色扮演主力（RP 优化）

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

推理 / 编程

💰 定价说明

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

🎭 SillyTavern 接入指南

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

配置步骤

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

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

🧩 Cline / VS Code 接入指南

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

配置步骤

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

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

📡 对话接口

POST /v1/chat/completions

请求参数

请求示例

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
  }'

❌ 错误码与响应

API 使用标准 HTTP 状态码指示请求成功或失败。

状态码说明

错误响应格式

所有错误返回如下结构的 JSON 对象：

{
  "error": {
    "message": "人类可读的错误描述",
    "type": "error_type_identifier",
    "code": "specific_error_code"
  }
}

常见错误类型

🚦 限流规则

并发限制

速率限制按 API Key 执行，超出限制时返回 429 状态码。

超限处理

当触发限流时，API 返回 HTTP 429 状态码：

{
  "error": {
    "message": "请求频率超限，请稍后重试",
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded"
  }
}

🔧 错误排查

❓ 常见问题

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

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

2. 支持哪些支付方式？

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

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

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

4. 支持哪些客户端？

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

5. 模型会经常变化吗？

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

6. 遇到问题怎么联系？

通过下方联系方式咨询，或在控制台提交工单。

📞 联系支持

如遇问题，可通过以下方式联系我们的技术支持团队：