Documentation Index
Fetch the complete documentation index at: https://docs.arouter.ai/llms.txt
Use this file to discover all available pages before exploring further.
ARouter 与任何支持 OpenAI Chat Completions API 的库或框架兼容。本页介绍最常用的集成方式。
官方 SDK
ARouter 为常用语言提供一流的 SDK：
Python SDK
pip install arouter
Node.js / TypeScript SDK
npm install arouter
Go SDK
go get github.com/arouter-ai/arouter-go
OpenAI SDK（任意语言）
由于 ARouter 与 OpenAI 兼容，官方 OpenAI SDK 开箱即用。只需修改 base_url 和 api_key：
from openai import OpenAI
client = OpenAI(
api_key="your-arouter-key",
base_url="https://api.arouter.ai/v1"
)
response = client.chat.completions.create(
model="openai/gpt-5.4",
messages=[{"role": "user", "content": "Hello!"}]
)
import OpenAI from "openai";
const client = new OpenAI({
apiKey: "your-arouter-key",
baseURL: "https://api.arouter.ai/v1",
});
const response = await client.chat.completions.create({
model: "openai/gpt-5.4",
messages: [{ role: "user", content: "Hello!" }],
});
LangChain
ARouter 可与 LangChain 的 ChatOpenAI 类配合使用：
from langchain_openai import ChatOpenAI
llm = ChatOpenAI(
model="anthropic/claude-sonnet-4-6",
openai_api_key="your-arouter-key",
openai_api_base="https://api.arouter.ai/v1",
)
response = llm.invoke("用一段话解释量子计算。")
print(response.content)
import { ChatOpenAI } from "@langchain/openai";
const llm = new ChatOpenAI({
modelName: "google/gemini-2.5-pro",
openAIApiKey: "your-arouter-key",
configuration: {
baseURL: "https://api.arouter.ai/v1",
},
});
const response = await llm.invoke("用一段话解释量子计算。");
console.log(response.content);
Vercel AI SDK
将 ARouter 用作 Vercel AI SDK 应用程序的后端：
import { createOpenAI } from "@ai-sdk/openai";
import { generateText } from "ai";
const arouter = createOpenAI({
apiKey: "your-arouter-key",
baseURL: "https://api.arouter.ai/v1",
});
const { text } = await generateText({
model: arouter("anthropic/claude-sonnet-4-6"),
prompt: "写一首关于海洋的短诗。",
});
console.log(text);
PydanticAI
from pydantic_ai import Agent
from pydantic_ai.models.openai import OpenAIModel
from openai import AsyncOpenAI
client = AsyncOpenAI(
api_key="your-arouter-key",
base_url="https://api.arouter.ai/v1",
)
model = OpenAIModel("openai/gpt-5.4", openai_client=client)
agent = Agent(model)
result = await agent.run("总结费曼讲义的核心思想。")
print(result.data)
Anthropic SDK（原生）
ARouter 还提供原生 Anthropic 兼容端点。无需 OpenAI 包装即可使用官方 Anthropic SDK：
import anthropic
client = anthropic.Anthropic(
api_key="your-arouter-key",
base_url="https://api.arouter.ai/anthropic",
)
message = client.messages.create(
model="claude-sonnet-4-6",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello, Claude!"}],
)
print(message.content[0].text)
Google Gemini SDK（原生）
ARouter 为官方 Google Generative AI SDK 提供 Gemini 兼容端点：
import google.generativeai as genai
genai.configure(
api_key="your-arouter-key",
client_options={"api_endpoint": "https://api.arouter.ai/gemini"}
)
model = genai.GenerativeModel("gemini-2.5-pro")
response = model.generate_content("简单解释相对论。")
print(response.text)
其他框架
任何具有 OpenAI 兼容适配器的框架都可以与 ARouter 配合使用。常见示例：
| 框架 | 集成方式 |
|---|
| AutoGen | 设置 model_client base URL |
| CrewAI | 使用 OpenAICompatibleModel 配合 ARouter base URL |
| LlamaIndex | 带自定义 base URL 的 OpenAI LLM 类 |
| Haystack | 带 ARouter API key 和 base URL 的 OpenAIChatGenerator |
| Semantic Kernel | 带自定义端点的 OpenAIChatCompletion |
base_url / api_base 配置——如果支持，ARouter 即可与之配合使用。
