Skip to main content
如果你的应用已经使用 OpenAI SDK，接入 XRouter 通常只需要改两处：
配置值
Base URLhttps://api.xrouter.dev/v1
API KeyXRouter 控制台创建的 sk-...
如果控制台显示了不同 server_address，请把示例中的 https://api.xrouter.dev 替换成控制台地址，并保留 OpenAI SDK 需要的 /v1 后缀。

​
Python

安装 SDK：
Terminal
pip install openai
设置环境变量：
Terminal
export XROUTER_API_KEY="sk-your-api-key"
发起请求：
Python
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.xrouter.dev/v1",
    api_key=os.environ["XROUTER_API_KEY"],
)

completion = client.chat.completions.create(
    model="your-model-id",
    messages=[
        {"role": "user", "content": "用一句话介绍 XRouter。"}
    ],
)

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

​
TypeScript

安装 SDK：
Terminal
npm install openai
设置环境变量：
Terminal
export XROUTER_API_KEY="sk-your-api-key"
发起请求：
TypeScript
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.xrouter.dev/v1",
  apiKey: process.env.XROUTER_API_KEY,
});

const completion = await client.chat.completions.create({
  model: "your-model-id",
  messages: [
    { role: "user", content: "用一句话介绍 XRouter。" },
  ],
});

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

​
Responses API

如果你的客户端使用 OpenAI Responses API，端点是： 
https://api.xrouter.dev/v1/responses
Python 示例：
Python
from openai import OpenAI

client = OpenAI(
    base_url="https://api.xrouter.dev/v1",
    api_key="sk-your-api-key",
)

response = client.responses.create(
    model="your-model-id",
    input="用一句话介绍 XRouter。",
)

print(response.output_text)

​
常见问题

检查是否正确设置了 base_url 或 baseURL。Python 使用 base_url，TypeScript 使用 baseURL。
先请求 /v1/models 或从控制台模型页复制模型 ID。不要直接套用其他平台的模型名。
确认使用的是 XRouter API Key，并且请求头最终是 Authorization: Bearer sk-...。