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 的兼容端点调用多种模型。

常见问题

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

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

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

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

可以混用多个模型吗?

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

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

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