返回首页

DOCS · 文档

使用文档

DunPolar 兼容 OpenAI 调用方式,只需要替换 Key 和 base_url,就可以把现有客户端接入到统一中转入口。

快速接入

在控制台创建 API Key 后,把客户端的 Base URL 指向 DunPolar 网关地址。模型名称可以按后台配置的别名填写。

model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://api.polarbear.wtf"
wire_api = "responses"
requires_openai_auth = true

模型配置

后台可以把 GPT、Claude、Gemini、DeepSeek、Qwen 等模型统一成一个入口。你可以按用户组设置可用模型、倍率、优先级和备用渠道。

model客户端实际填写的模型名或别名。
provider模型上游渠道,例如 OpenAI、Claude、Gemini。
group按用户套餐或业务场景分组。
fallback主渠道异常时自动切换到备用渠道。

图像接口

gpt-image-2 已完整接入,文生图和图像编辑共用同一个 Key。客户端保持 OpenAI 兼容协议,业务侧无需维护多套鉴权。

推荐把图像能力单独放入高质量分组,便于设置倍率、并发限制和余额提醒。

计费说明

请求会按模型、分组和倍率记录用量。用户可以在后台查看余额、消耗明细和错误日志,方便定位成本与异常。

常见问题

需要改 SDK 吗?

通常不需要。只要你的客户端支持 OpenAI 兼容协议,替换 API Key 和 Base URL 即可。

可以给不同用户不同模型吗?

可以。你可以按用户组、套餐或项目配置可用模型和计费倍率。

上游渠道异常怎么办?

建议配置备用渠道和失败重试策略,减少单个上游波动对用户的影响。