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 即可與之配合使用。
