外观
从 OpenRouter 切换到 NiceAI
OpenRouter 和 NiceAI 都提供 OpenAI 兼容接口,切换时一般只需改三处:Base URL、API 密钥、模型名。OpenRouter 特有的路由参数和请求头需要去掉或忽略。
对照表
| 项目 | OpenRouter | NiceAI |
|---|---|---|
| OpenAI 兼容 Base URL | https://openrouter.ai/api/v1 | https://api.niceai.dev/v1 |
| Anthropic 协议 | 以 OpenRouter 文档为准 | https://api.niceai.dev(不加 /v1) |
| API 密钥 | OpenRouter Key | 在 控制台 创建,并选择分组 |
| 模型名 | 厂商/模型 格式 | 以 模型广场 显示的名称为准 |
第 1 步:改 Base URL 和密钥
以 OpenAI Python SDK 为例:
python
# 之前
client = OpenAI(base_url="https://openrouter.ai/api/v1", api_key=OPENROUTER_KEY)
# 之后
client = OpenAI(base_url="https://api.niceai.dev/v1", api_key=NICEAI_KEY)使用环境变量的项目,改 OPENAI_BASE_URL 和 OPENAI_API_KEY 即可。
第 2 步:替换模型名
OpenRouter 的模型名带厂商前缀,NiceAI 使用模型广场中显示的名称。建议在代码里集中定义一张映射表,而不是到处替换字符串:
python
MODEL = {
"chat": "<模型名,见模型广场>",
"coding": "<模型名,见模型广场>",
}也可以调用 GET https://api.niceai.dev/v1/models 查看当前密钥可用的模型。
第 3 步:处理 OpenRouter 专有参数
下面这些是 OpenRouter 的扩展,不属于 OpenAI 标准接口,迁移时建议删除:
| OpenRouter 专有内容 | 处理方法 |
|---|---|
HTTP-Referer、X-Title 请求头 | 删除 |
请求体中的 provider 路由偏好 | 删除 |
请求体中的 models 备选模型数组 | 删除,改为在你自己的代码里做失败重试或降级 |
模型名后缀(如 :free、:online 之类) | 删除,改用模型广场中的名称 |
标准字段(messages、tools、stream、temperature、max_tokens 等)保持不变。
第 4 步:验证
bash
curl https://api.niceai.dev/v1/chat/completions \
-H "Authorization: Bearer $NICEAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "<模型名,见模型广场>", "messages": [{"role": "user", "content": "你好"}]}'客户端里怎么切
在 Cursor、Cline、Cherry Studio 等客户端里,把 OpenRouter 的地址和密钥换成 NiceAI 的即可,具体见 支持的客户端一览。
迁移检查清单
- Base URL 已改为
https://api.niceai.dev/v1 - 密钥已替换,分组与要用的模型对应
- 模型名已按模型广场替换
- 已删除 OpenRouter 专有参数和请求头
- 小流量验证通过,并在控制台使用记录中看到请求