DunPolar使用教程

准备工作

开始前请准备一个可用邮箱。新用户注册后默认为 0.5 余额。

使用步骤

按顺序完成以下步骤即可获得可用的 API Key。

1. 1

   注册账号

   访问首页右上角 登录 / 注册，使用邮箱注册新账号。新用户默认为 0.5 余额。

2. 2

   充值（可选）

   在侧边栏 充值 页面选择金额，完成支付后余额自动到账。

3. 3

   创建 API Key

   进入侧边栏 API 密钥，点击新建，选择服务分组，命名后保存。

配置示例

这里填写配置说明。下面的代码块可以替换成你自己的配置内容。

base_url = "https://api.polarbear.wtf"
api_key = "你的 API Key"
model = "你的模型名称"

注意事项

这里填写使用中需要注意的限制、计费、模型选择、报错处理或安全建议。

API Key 管理

Key 的创建 / 启用 / 禁用 / 删除 / 限速。

API Key 是访问网关的凭据，每个 Key 绑定到一个服务分组，继承该分组的模型、费率和限制。

创建 Key

侧边栏 API 密钥 → 新建，需要选择 服务分组，服务分组决定可用模型和倍率。

启用 / 禁用

在 Key 列表点击 启用 / 禁用 切换状态。禁用后立即生效，不影响已生成的请求。

限速

每个 Key 可设置 RPM（每分钟请求数）上限。0 = 不限制，走所属分组兜底。

安全建议

• 不要把 Key 提交到 git 仓库
• 可疑泄露时立即删除并新建
• 生产环境与测试环境分别建 Key

并发与限流

账号 / Key / 分组三级限流如何叠加。

系统采用三层限流模型，优先级从高到低：Key 级别 → 账号级别 → 分组级别。

账号并发

个人资料页可看到 并发限制（默认 5）。同一时刻最多 5 个未完成请求。

Key 级 RPM

API Key 可单独设置 RPM。RPM = 0 时回退到分组的 RPM 限制。

分组限流

分组的 RPM / TPM / 日预算是共享的兜底，所有该分组下的 Key 共用。

命中限流如何处理？

HTTP/1.1 429 Too Many Requests
{"error":{"type":"rate_limit_exceeded","message":"..."}}

客户端应实现 指数退避重试：初始 1s，最大 32s，最多 5 次。

充值流程

4 种支付方式、几分钟完成充值、即刻到账。

充值的钱会 1:1 进入你的账户余额，既可用于后续按量计费的所有调用，又会自动累加到 VIP 升级进度里。

支持的支付方式

支付宝 — 扫码或移动端打开。

三步完成充值

1. 1

   进入充值页

   从侧边栏点击 充值 进入充值页。

2. 2

   填写金额

   输入想充值的金额（最低 $1），选择喜欢的支付方式。

3. 3

   完成支付

   按提示完成支付，通常 5-30 秒内到账。

支付成功后，首页会自动弹出一张纸张小票，上面有订单号、金额、支付时间。可以拖动它放到屏幕喜欢的位置，双击就能关上。

没看到到账？

如果支付了但 1 分钟还没看到余额变化：

• 先刷新一下页面，大多数情况会立刻看到
• 进入侧边栏的 我的订单 页面查看这笔订单是否已经显示完成
• 如果订单一直显示等待中，联系客服并提供订单号

找回历史小票

每一笔成功的充值都可以重新查看小票：进入 我的订单，找到那笔订单，点击 查看小票 就能再次打开纸张小票。

常见问题

充值与余额相关的常见问题。

为什么我们是真的中转

不靠营销话术，用具体技术细节告诉你我们做了什么。

AI 中转站这个赛道，劣币驱逐良币的现象很严重。本节用可验证的技术事实，说清楚我们做了什么、不做什么，以及你如何自己核实。营销话术不能保真，代码细节可以。

请求正文 · 永不入库

你打过来的 prompt、消息内容、上下文、上传的图片、tool call 参数，从不写入我们的数据库或日志。

• User-Agent — 你用的客户端（SDK 版本 / IDE）
• token 计数 — input_tokens、output_tokens、cached_tokens
• model — 调用的模型名
• created_at — 调用时间戳
• status_code — HTTP 状态码
• upstream_account_id — 调度到哪个上游账号
• latency_ms — 端到端耗时

计费可对账

计费完全按上游 usage 字段。我们透传 response_id / chat_id。

# Anthropic 响应（透传）
{"id":"msg_01ABC...","model":"claude-sonnet-4-6","usage":{"input_tokens":1234,"output_tokens":567}}

隐私边界 · 我们存什么

详细的字段级隐私清单，逐项说明存什么不存什么。

可用模型一览

完整可用模型列表请前往侧边栏 模型与价格 页面查看实时定价与可用性。

Claude 系列

• claude-opus-4-7 — 最强大，适合复杂推理与长文本
• claude-sonnet-4-6 — 平衡之选，日常应用首选
• claude-haiku-4-5 — 最快、最便宜，适合高频小任务

OpenAI 系列

• gpt-5 — 旗舰，带原生多模态
• gpt-5-mini — 性价比之选

Google Gemini 系列

• gemini-2.5-pro — 长上下文与多模态
• gemini-2.5-flash — 极速响应

如何选模型

按场景推荐 · 成本 / 速度 / 质量权衡。

调用最佳实践

提示词模板 · 缓存策略 · 错误重试。

错误重试

建议对 5xx 和 429 实现指数退避重试：初始 1s，每次 ×2，最多 5 次，最大间隔 32s。

限制输出长度

明确指定 max_tokens，避免输出过长造成成本增加。

Claude Code CLI 接入

推荐用 CC-Switch 一键添加 · 也支持环境变量手动配置。

Claude Code 是 Anthropic 官方的命令行编程助手。指向 DunPolar 网关后，你的调用都通过我们中转。

cc add dunpolar   --base-url https://api.your-domain.com   --token sk-xxxxxxxxxxxxxxx
cc use dunpolar

OpenAI Codex CLI 接入

把 Codex 指向 DunPolar 网关 · 兼容 OpenAI 协议。

完整截图步骤可从上方图文教程进入。

# ~/.codex/config.toml
model_provider = "dunpolar"
model = "gpt-5"

[model_providers.dunpolar]
name = "DunPolar"
base_url = "https://api.your-domain.com/v1"
wire_api = "responses"
env_key = "DUNPOLAR_API_KEY"

export DUNPOLAR_API_KEY="sk-xxxxxxxxxxxxxxx"

Gemini CLI 接入

把 Gemini CLI 指向 DunPolar 网关 · 百万级上下文。

export GOOGLE_GEMINI_BASE_URL="https://api.your-domain.com"
export GEMINI_API_KEY="sk-xxxxxxxxxxxxxxx"

SDK 与 cURL 直调

Python / Node SDK · cURL 一行直调。

curl https://api.your-domain.com/v1/chat/completions   -H "Authorization: Bearer sk-xxxxxxxxxxxxxxx"   -H "Content-Type: application/json"   -d '{"model":"gpt-5","messages":[{"role":"user","content":"hi"}]}'

Node.js · Windows

一步装好 Node.js · MSI 安装包 + PowerShell 验证。

node -v
npm -v

Node.js · macOS

用 Homebrew + nvm 装 Node.js · 多版本管理友好。

brew install nvm
nvm install --lts

Node.js · Linux

Ubuntu / Debian / CentOS · 用 nvm 装 Node.js。

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install --lts

网络与代理

国内直连 · 不需要科学上网 · 节点稳定性。

DunPolar 网关部署在境内 + 海外多节点，国内用户直接访问 API 域名即可，不需要额外代理。我们已经处理了与上游 Anthropic / OpenAI / Google 的网络通路。

测试连通性

curl -I https://api.your-domain.com/health
# 期望 HTTP/2 200

如果你确实在用代理

大部分情况下你不需要代理。如果终端默认走了系统代理，cURL / SDK 可能会经过代理，反而增加延迟。可以临时关闭：

# macOS / Linux
unset HTTP_PROXY HTTPS_PROXY

# Windows PowerShell
$env:HTTP_PROXY=$null
$env:HTTPS_PROXY=$null

企业网 / 校园网

少数企业或校园网络会拦截非白名单域名。如果 curl 失败，可以联系网管把 API 域名加入白名单。

查看真实延迟

侧边栏 服务状态 会展示到上游供应商的延迟统计，包括中位数、P95 和 SLA，可作为选模型和排查网络问题的参考。