从 OpenAI API 切换到 RouteScope

将已有 OpenAI SDK、curl 或 OpenAI 兼容客户端迁移到 RouteScope 的最小改动清单。

如果你的项目已经能调用 OpenAI API，切到 RouteScope 通常只需要改三处：Base URL、API Key 和模型名。请求格式仍然使用 OpenAI 兼容格式。

配置项	OpenAI	RouteScope
Base URL	`https://api.openai.com/v1`	`https://api.routescope.ai/v1`
API Key	OpenAI Key	RouteScope 令牌管理里创建的 `sk-...`
模型名	OpenAI 模型名	模型广场或 `/v1/models` 返回的模型名

Base URL 不要填错

OpenAI 兼容客户端要填写 https://api.routescope.ai/v1。不要填官网地址，也不要把 /v1 漏掉。

1. 创建 RouteScope API Key

进入 RouteScope 控制台，在令牌管理创建 API Key。复制完整的 sk-...，不要只复制前缀或后几位。

如果你还不确定当前账号能调用哪些模型，先打开模型广场，或用下面的接口检查：

curl https://api.routescope.ai/v1/models \
  -H "Authorization: Bearer sk-your-token"

2. 替换已有 OpenAI SDK 配置

JavaScript / TypeScript

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.ROUTESCOPE_API_KEY,
  baseURL: "https://api.routescope.ai/v1",
});

const completion = await client.chat.completions.create({
  model: "your-routescope-model",
  messages: [{ role: "user", content: "请回复 RouteScope 已连接" }],
});

console.log(completion.choices[0]?.message?.content);

如果你的项目里已经固定读取 OPENAI_API_KEY，可以继续用这个环境变量名，只要变量值换成 RouteScope 的 API Key，并把 Base URL 改成 RouteScope。

Python

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-token",
    base_url="https://api.routescope.ai/v1",
)

resp = client.chat.completions.create(
    model="your-routescope-model",
    messages=[{"role": "user", "content": "请回复 RouteScope 已连接"}],
)

print(resp.choices[0].message.content)

curl

curl https://api.routescope.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-your-token" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-routescope-model",
    "messages": [
      {
        "role": "user",
        "content": "请回复 RouteScope 已连接"
      }
    ]
  }'

3. 保持接口路径不变

OpenAI 兼容接口的路径继续按原来的写法使用：

能力	RouteScope 路径
模型列表	`GET /v1/models`
聊天补全	`POST /v1/chat/completions`
图像生成	`POST /v1/images/generations`
图像编辑	`POST /v1/images/edits`

完整 URL 由 Base URL 和路径组成。例如聊天补全就是 https://api.routescope.ai/v1/chat/completions。

4. 验证是否真的走到 RouteScope

请求成功后，到控制台的操作记录查看这次调用。重点确认这几项：

检查项	说明
模型名	是否是你请求里填写的 RouteScope 模型
令牌	是否是本次创建的 API Key
状态	是否成功，失败时查看错误原因
消耗	是否产生了本次调用的 token 和费用记录

常见问题

现象	处理方式
`401` 或 `403`	检查 API Key 是否完整、是否禁用、是否有额度或权限限制。
`404` 或模型不存在	用 `/v1/models` 或模型广场确认当前账号可用的模型名。
工具仍然请求 OpenAI	检查 SDK、代理层或客户端里是否还有旧的 Base URL。
Claude 原生接口无法调用	Claude Messages 接口使用 `https://api.routescope.ai/v1/messages`，不要套 OpenAI SDK 的路径。