> ## 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.

# 框架与集成

> 在流行的 AI 框架和 SDK 中使用 ARouter——只需修改 base_url 和 api_key，无需其他代码改动。

ARouter 与任何支持 OpenAI Chat Completions API 的库或框架兼容。本页介绍最常用的集成方式。

## 官方 SDK

ARouter 为常用语言提供一流的 SDK：

<CardGroup cols={2}>
  <Card title="Python SDK" icon="python" href="/zh/sdks/python">
    pip install arouter
  </Card>

  <Card title="Node.js / TypeScript SDK" icon="js" href="/zh/sdks/node">
    npm install arouter
  </Card>

  <Card title="Go SDK" icon="golang" href="/zh/sdks/go">
    go get github.com/arouter-ai/arouter-go
  </Card>

  <Card title="cURL" icon="terminal" href="/zh/sdks/curl">
    直接 HTTP 示例
  </Card>
</CardGroup>

## OpenAI SDK（任意语言）

由于 ARouter 与 OpenAI 兼容，官方 OpenAI SDK 开箱即用。只需修改 `base_url` 和 `api_key`：

<Tabs>
  <Tab title="Python">
    ```python theme={null}
    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!"}]
    )
    ```
  </Tab>

  <Tab title="Node.js">
    ```typescript theme={null}
    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!" }],
    });
    ```
  </Tab>
</Tabs>

## LangChain

ARouter 可与 LangChain 的 `ChatOpenAI` 类配合使用：

<Tabs>
  <Tab title="Python">
    ```python theme={null}
    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)
    ```
  </Tab>

  <Tab title="Node.js">
    ```typescript theme={null}
    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);
    ```
  </Tab>
</Tabs>

## Vercel AI SDK

将 ARouter 用作 Vercel AI SDK 应用程序的后端：

```typescript theme={null}
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

```python theme={null}
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：

```python theme={null}
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](/zh/api-reference/anthropic/create-message)。

## Google Gemini SDK（原生）

ARouter 为官方 Google Generative AI SDK 提供 Gemini 兼容端点：

```python theme={null}
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](/zh/api-reference/gemini/generate-content)。

## 其他框架

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