跳转到主要内容
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

cURL

直接 HTTP 示例

OpenAI SDK(任意语言)

由于 ARouter 与 OpenAI 兼容,官方 OpenAI SDK 开箱即用。只需修改 base_urlapi_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!"}]
)

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)

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)
完整参考请参阅 Anthropic 原生 API

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)
完整参考请参阅 Gemini 原生 API

其他框架

任何具有 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 即可与之配合使用。