接入概览

  • 把 OAIRoute 接进你已经在用的工具
  • 大多数客户端只需要填一个地址和一把 Key
  • 下面按工具类型分组，点进去看具体步骤

先准备好两样东西

string必填

一律填 https://api.oairoute.com/v1。只有 Seedream 系列与 Seedance 系列例外，走 https://ark.oairoute.com/v1。

string必填

在 OAIRoute 控制台 创建，文本、语音与大部分图像视频共用这一把。Seedream 与 Seedance 系列需要到 ark 站 另行获取，两站 Key 不通用。

地址带不带 /v1

这是接入时最容易出错的地方。不同客户端的叫法不一样：

客户端说填什么
Base URL / API 地址https://api.oairoute.com/v1
API 域名 / Hosthttps://api.oairoute.com
完整端点https://api.oairoute.com/v1/chat/completions

填错的表现是 404。不确定时先按「Base URL」的写法试，不行再去掉 /v1。

按工具选

聊天应用：ChatBox、Cherry Studio、AnythingLLM。装好就能用，配置项最少。

开发工具：Claude Code、Codex CLI、Gemini CLI、Cline、Roo Code、OpenCode、Cherry Studio、LangChain、Cursor、CC-Switch。这些需要改配置文件或环境变量。

应用平台：Dify、沉浸式翻译。适合把 OAIRoute 当作底层模型供应方，搭自己的应用。

一个通用的验证方法

配置完之后，先用 curl 确认端点通不通，再判断是客户端的问题还是配置的问题：

curl https://api.oairoute.com/v1/models \
  -H "Authorization: Bearer YOUR_OAIRoute_KEY"

返回模型列表说明网络与 Key 都没问题。这一步不通，客户端里怎么调都不会通。

所有接入方式共用同一个额度池。如果某个工具出现 429，先看是不是多个工具在同时跑高并发，而不是单独怀疑那个工具。