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

# 从 OpenAI / Anthropic 官方 API 切换

NiceAI 兼容 OpenAI 和 Anthropic 的官方接口格式。从官方 API 切换时，只需要把 Base URL 和 API 密钥换成 NiceAI 的，再核对一下模型名，请求和响应的结构都不用改。

## 改哪几处

| 项目 | 官方 | NiceAI |
| --- | --- | --- |
| OpenAI Base URL | `https://api.openai.com/v1` | `https://api.niceai.dev/v1` |
| Anthropic Base URL | `https://api.anthropic.com` | `https://api.niceai.dev` |
| API 密钥 | 官方 Key | 在 [控制台](https://niceai.dev/keys) 创建：OpenAI 用 OpenAI 分组，Claude 用 Claude 分组 |
| 模型名 | 官方模型 ID | 以 [模型广场](https://niceai.dev/model-plaza) 为准 |

## 只改环境变量

如果项目通过环境变量读取配置，代码不用动：

```bash
# OpenAI
export OPENAI_BASE_URL="https://api.niceai.dev/v1"
export OPENAI_API_KEY="你的 NiceAI 密钥"

# Anthropic
export ANTHROPIC_BASE_URL="https://api.niceai.dev"
export ANTHROPIC_API_KEY="你的 NiceAI 密钥"
```

## 改代码

```python
# OpenAI
client = OpenAI(base_url="https://api.niceai.dev/v1", api_key=NICEAI_KEY)

# Anthropic（注意不加 /v1）
client = anthropic.Anthropic(base_url="https://api.niceai.dev", api_key=NICEAI_KEY)
```

完整示例见 [OpenAI SDK 接入](https://wiki.niceai.dev/guide/clients/openai-sdk) 和 [Anthropic SDK 接入](https://wiki.niceai.dev/guide/clients/anthropic-sdk)。

## 需要额外核对的地方

- **模型名**：常用模型一般与官方 ID 一致，但以模型广场为准，上线前逐个确认。
- **官方专属功能**：官方平台上的文件存储、Batch、微调、Assistants 等账号级功能不一定可用，迁移前用小请求单独测试。
- **组织和项目参数**：`OpenAI-Organization`、`OpenAI-Project` 这类请求头是官方账号体系的，可以去掉。
- **限流和重试**：保留原有的重试逻辑，对 429、5xx 做指数退避，见 [常见错误码对照](https://wiki.niceai.dev/guide/error-codes)。
- **费用核对**：切换后在控制台使用记录中查看每次请求的 token 和扣费，计费规则见 [分组与倍率说明](https://wiki.niceai.dev/guide/billing-groups)。

## 客户端

Claude Code、Codex 这类工具同样只需改地址和密钥：

- [Claude Code 接入](https://wiki.niceai.dev/guide/claude-code)
- [Codex CLI 接入](https://wiki.niceai.dev/guide/codex)

## 下一步

- [从 OpenRouter 切换](https://wiki.niceai.dev/guide/migrate-from-openrouter)
- [常见问题 FAQ](https://wiki.niceai.dev/guide/faq)
