从 OpenAI 迁移

大多数 OpenAI 兼容应用只需要修改三个配置:

  1. 替换 API Key。
  2. 将 Base URL 设置为 https://getrouter.ai/v1
  3. 选择 GetRouter 中可用的模型 ID。

Python

迁移前:

from openai import OpenAI

client = OpenAI(api_key="OPENAI_API_KEY")

迁移后:

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://getrouter.ai/v1",
)

response = client.chat.completions.create(
    model="MODEL_ID",
    messages=[{"role": "user", "content": "你好"}],
)

Node.js / TypeScript

迁移前:

const client = new OpenAI({ apiKey: process.env.OPENAI_API_KEY })

迁移后:

const client = new OpenAI({
  apiKey: process.env.GETROUTER_API_KEY,
  baseURL: 'https://getrouter.ai/v1',
})

const response = await client.chat.completions.create({
  model: 'MODEL_ID',
  messages: [{ role: 'user', content: '你好' }],
})

环境变量

如果应用读取标准 OpenAI 环境变量,通常可以只修改运行时配置:

export OPENAI_API_KEY="YOUR_API_KEY"
export OPENAI_BASE_URL="https://getrouter.ai/v1"

环境变量名称由具体应用决定,请确认 SDK 或工具支持自定义 Base URL。

检查功能兼容性

GetRouter 支持 OpenAI 兼容请求格式,但具体能力取决于模型和接口。请验证应用实际使用的功能:

  • Chat Completions 或 Responses API
  • 流式输出
  • Tool / Function Calling
  • 结构化输出
  • 视觉或其他多模态输入
  • Embeddings、图片或音频
Tip

先使用简短的非流式请求完成迁移,再逐项启用流式输出、Tools、推理和其他高级字段。

常见迁移问题

请求仍发送到原服务商

确认应用确实读取了自定义 Base URL。部分应用只在启动时加载环境变量。

URL 中出现 /v1/v1

应用可能会自动添加 /v1,请按照该客户端要求的 Base URL 格式填写。

模型被拒绝

将原服务商模型名称替换为 GetRouter 模型页面中的准确 ID。

Chat 可用但 Responses 不可用

两个 API 使用不同接口和流式事件格式。请确认模型和工具支持 POST /v1/responses

下一步