QuickRouter API 大模型API聚合中转平台QuickRouter API

OpenAI SDK 兼容接口配置教程

OpenAI SDK 是调用大模型最广泛使用的开发工具。通过 QuickRouter 的兼容接口,开发者可以使用同一个 OpenAI SDK 调用 Claude、GPT-5、Gemini、DeepSeek 等多种模型,只需配置一次 Base URL。

配置前准备

1安装 OpenAI SDK(pip install openai 或 npm install openai)
2注册 QuickRouter 获取 API Key

配置方法

1
安装 OpenAI SDK
terminal
pip install openai  # Python
npm install openai  # Node.js
2
在代码中设置 base_url 为 https://api.quickrouter.ai/v1,将 api_key 替换为 QuickRouter 的 API Key
openai_sdk_compatible.mjs
import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: process.env.QUICKROUTER_API_KEY,
  baseURL: 'https://api.quickrouter.ai',
});
3
在 model 参数中指定模型,调用方式和原生 OpenAI SDK 完全一致
openai_sdk_compatible.mjs
const response = await client.chat.completions.create({
  model: 'claude-sonnet-4-6',  // 或 gpt-5, deepseek-chat, gemini-2.5-pro
  messages: [{ role: 'user', content: '你好' }],
});

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

常见工具配置

OpenAI SDK 兼容接口不仅支持 Python 和 Node.js,还支持所有基于 HTTP 的客户端(如 cURL、Go、Java 等)。只要是遵循 OpenAI Chat Completions 协议的客户端,都可以通过 QuickRouter 的兼容端点调用多种模型。
下一步配置

选择你的工具,完成第一次调用

如果你是从搜索进入本页,可以直接按正在使用的工具复制 API Key、Base URL、模型示例,并跳转到对应配置教程。

Claude

Claude Code

CLI
API Key:
登录后台 → API令牌 → 复制
Base URL:
https://api.quickrouter.ai
模型示例:
claude-sonnet-4-6
填写位置:
环境变量或 ~/.claude/settings.json
查看 Claude Code 配置教程
opencode

opencode

Terminal
API Key:
登录后台 → API令牌 → 复制
Base URL:
https://api.quickrouter.ai/v1
模型示例:
claude-sonnet-4-6
填写位置:
~/.config/opencode/opencode.json+auth.json
查看 opencode 配置教程
Cursor

Cursor

IDE
API Key:
登录后台 → API令牌 → 复制
Base URL:
https://api.quickrouter.ai/v1
模型示例:
claude-sonnet-4-6
填写位置:
Settings → Models
查看 Cursor 配置教程
OpenAI

Codex

Agent
API Key:
登录后台 → API令牌 → 复制
Base URL:
https://api.quickrouter.ai/v1
模型示例:
gpt-5.5
填写位置:
~/.codex/config.toml + ~/.codex/auth.json
查看 Codex 配置教程
Cherry Studio

Cherry Studio

Desktop
API Key:
登录后台 → API令牌 → 复制
Base URL:
https://api.quickrouter.ai
模型示例:
claude-sonnet-4-6
填写位置:
设置 → 添加 → 添加提供商
查看 Cherry Studio 配置教程
Trae

Trae

Builder
API Key:
登录后台 → API令牌 → 复制
一般模型 URL:
https://api.quickrouter.ai/v1/chat/completions
Claude 模型 URL:
https://api.quickrouter.ai/anthropic/v1/messages
模型示例:
gpt-5.5 / claude-sonnet-4-6
填写位置:
Settings → Models → Custom Model
查看 Trae 配置教程

常见问题

OpenAI SDK 的所有功能都支持吗?

支持 Chat Completions、Stream 流式输出、Embeddings 等核心功能。部分较新的实验性功能可能需要等待支持。

如何在 Python 和 Node.js 之间选择?

两者功能完全一致,选择你项目使用的语言即可。QuickRouter 对两种 SDK 都完全兼容。

可以混用多个模型吗?

可以。同一个 API Key 和 Base URL 可以调用所有支持的模型。在请求中切换 model 参数即可。

错误处理和官方 SDK 一样吗?

是的。错误格式和错误码与 OpenAI 官方保持一致,现有的错误处理代码无需修改。