Source: https://wiki.niceai.dev/guide/migrate-from-openrouter

# 从 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 | 在 [控制台](https://niceai.dev/keys) 创建，并选择分组 |
| 模型名 | `厂商/模型` 格式 | 以 [模型广场](https://niceai.dev/model-plaza) 显示的名称为准 |

## 第 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 的即可，具体见 [支持的客户端一览](https://wiki.niceai.dev/guide/clients/)。

## 迁移检查清单

- Base URL 已改为 `https://api.niceai.dev/v1`
- 密钥已替换，分组与要用的模型对应
- 模型名已按模型广场替换
- 已删除 OpenRouter 专有参数和请求头
- 小流量验证通过，并在控制台使用记录中看到请求

## 下一步

- [从官方 API 迁移](https://wiki.niceai.dev/guide/migrate-from-official-api)
- [分组与倍率说明](https://wiki.niceai.dev/guide/billing-groups)
