# 接入概览
> 把 OAIRoute 接进你已经在用的工具
> 大多数客户端只需要填一个地址和一把 Key
> 下面按工具类型分组，点进去看具体步骤
## 先准备好两样东西
- `API 地址` (string / 必填) — 一律填 `https://api.oairoute.com/v1`。只有 Seedream 系列与 Seedance 系列例外，走 `https://ark.oairoute.com/v1`。
- `API Key` (string / 必填) — 在 [OAIRoute 控制台](https://api.oairoute.com/keys) 创建，文本、语音与大部分图像视频共用这一把。Seedream 与 Seedance 系列需要到 [ark 站](https://ark.oairoute.com/) 另行获取，两站 Key 不通用。
## 地址带不带 /v1
这是接入时最容易出错的地方。不同客户端的叫法不一样：
| 客户端说 | 填什么 |
|---|---|
| Base URL / API 地址 | `https://api.oairoute.com/v1` |
| API 域名 / Host | `https://api.oairoute.com` |
| 完整端点 | `https://api.oairoute.com/v1/chat/completions` |
填错的表现是 404。不确定时先按「Base URL」的写法试，不行再去掉 `/v1`。
## 按工具选
**聊天应用**：ChatBox、Cherry Studio、AnythingLLM。装好就能用，配置项最少。
**开发工具**：Claude Code、Cursor、Cline、Gemini CLI、Codex CLI、CC-Switch。这些需要改配置文件或环境变量。
**应用平台**：Dify、沉浸式翻译。适合把 OAIRoute 当作底层模型供应方，搭自己的应用。
## 一个通用的验证方法
配置完之后，先用 curl 确认端点通不通，再判断是客户端的问题还是配置的问题：
```bash
curl https://api.oairoute.com/v1/models \
  -H "Authorization: Bearer YOUR_OAIRoute_KEY"
```
返回模型列表说明网络与 Key 都没问题。这一步不通，客户端里怎么调都不会通。
> **Note:** 
> 所有接入方式共用同一个额度池。如果某个工具出现 429，先看是不是多个工具在同时跑高并发，而不是单独怀疑那个工具。