外观
从 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 | 在 控制台 创建:OpenAI 用 OpenAI 分组,Claude 用 Claude 分组 |
| 模型名 | 官方模型 ID | 以 模型广场 为准 |
只改环境变量
如果项目通过环境变量读取配置,代码不用动:
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 接入 和 Anthropic SDK 接入。
需要额外核对的地方
- 模型名:常用模型一般与官方 ID 一致,但以模型广场为准,上线前逐个确认。
- 官方专属功能:官方平台上的文件存储、Batch、微调、Assistants 等账号级功能不一定可用,迁移前用小请求单独测试。
- 组织和项目参数:
OpenAI-Organization、OpenAI-Project这类请求头是官方账号体系的,可以去掉。 - 限流和重试:保留原有的重试逻辑,对 429、5xx 做指数退避,见 常见错误码对照。
- 费用核对:切换后在控制台使用记录中查看每次请求的 token 和扣费,计费规则见 分组与倍率说明。
客户端
Claude Code、Codex 这类工具同样只需改地址和密钥: