文档 / SDK 与框架

SDK 与框架

RelayRouter 可与任何支持自定义 OpenAI 兼容端点的工具或框架配合使用。你只需要修改 base URL 和 API 密钥。

配置项	取值
`baseURL / base_url`	https://relayrouter.io/v1
`apiKey / api_key`	你的 RelayRouter API 密钥

#OpenAI SDK（无缝替换）

TypeScript

index.tstypescript

import OpenAI from "openai";

// 只需修改两个值，其余保持不变。
const client = new OpenAI({
  apiKey: process.env.RELAYROUTER_API_KEY,
  baseURL: "https://relayrouter.io/v1",
});

const response = await client.chat.completions.create({
  model: "claude-opus-4-8",
  messages: [{ role: "user", content: "Hello!" }],
});
console.log(response.choices[0].message.content);

Python

main.pypython

from openai import OpenAI
import os

client = OpenAI(
    api_key=os.environ["RELAYROUTER_API_KEY"],
    base_url="https://relayrouter.io/v1",
)

response = client.chat.completions.create(
    model="claude-opus-4-8",
    messages=[{"role": "user", "content": "Hello!"}],
)
print(response.choices[0].message.content)

#Anthropic SDK（原生协议）

网关在 POST /v1/messages 上同样支持 Anthropic 协议，因此官方 Anthropic SDK 无需任何适配器即可使用。将 base_url 设为 https://relayrouter.io（站点根地址，而非 /v1），并保持代码不变即可。Gemini 风格的 /v1beta 端点也同样可用。

anthropic_sdk.pypython

import anthropic
import os

client = anthropic.Anthropic(
    api_key=os.environ["RELAYROUTER_API_KEY"],
    base_url="https://relayrouter.io",
)

msg = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}],
)
print(msg.content[0].text)

#LangChain

langchain_example.pypython

from langchain_openai import ChatOpenAI
import os

llm = ChatOpenAI(
    model="claude-opus-4-8",
    openai_api_key=os.environ["RELAYROUTER_API_KEY"],
    openai_api_base="https://relayrouter.io/v1",
)

res = llm.invoke("What is the capital of France?")
print(res.content)

#LiteLLM

litellm_example.pypython

import litellm, os

response = litellm.completion(
    model="openai/claude-opus-4-8",  # openai/ 前缀用于选择兼容 OpenAI 的驱动
    messages=[{"role": "user", "content": "Hello!"}],
    api_key=os.environ["RELAYROUTER_API_KEY"],
    api_base="https://relayrouter.io/v1",
)
print(response.choices[0].message.content)

#其他兼容 OpenAI 的工具

桌面应用和网页界面（如 Chatbox、Cherry Studio、OpenWebUI 等）的用法相同：选择 OpenAI 服务商类型，设置 base URL，并粘贴你的密钥。 base URL 为 https://relayrouter.io/v1。

配置第三方工具时，base URL 务必包含 /v1 后缀。

←How It Works MCP Server→