Skip to content

从 OpenRouter 切换到 NiceAI ​

OpenRouter 和 NiceAI 都提供 OpenAI 兼容接口,切换时一般只需改三处:Base URL、API 密钥、模型名。OpenRouter 特有的路由参数和请求头需要去掉或忽略。

对照表 ​

项目OpenRouterNiceAI
OpenAI 兼容 Base URLhttps://openrouter.ai/api/v1https://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 专有参数和请求头
  • 小流量验证通过,并在控制台使用记录中看到请求

下一步 ​

NiceAI · 稳定的 AI 大模型 API 中转站