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

# SDK 下載

> 下載 ARouter 官方 SDK，整合到您的應用程式中。

## 官方 SDK

ARouter 提供官方 SDK，全面支援對話補全、串流輸出、key 管理和 provider 代理。

<CardGroup cols={2}>
  <Card title="Go SDK" icon="golang" href="https://github.com/arouter-ai/arouter-go">
    **現已可用** — 零依賴，生產就緒。

    ```bash theme={null}
    go get github.com/arouter-ai/arouter-go
    ```

    <sub>需要 Go 1.21+ · [文件 →](/zh-Hant/sdks/go)</sub>
  </Card>

  <Card title="Node.js SDK" icon="node-js" href="https://github.com/arouter-ai/arouter-node">
    **即將推出** — 完整 TypeScript 支援。

    ```bash theme={null}
    npm install @arouter/sdk
    ```

    <sub>預覽版 · [文件 →](/zh-Hant/sdks/node#arouter-sdk)</sub>
  </Card>

  <Card title="Python SDK" icon="python">
    **計劃中** — 原生 Python SDK，支援非同步。

    <sub>開發中 · 上線時間待定</sub>
  </Card>
</CardGroup>

***

## Go SDK

ARouter 官方 Go SDK，輕量、零依賴、符合 Go 慣用風格。

|              |                                                    |
| ------------ | -------------------------------------------------- |
| **套件名稱**     | `github.com/arouter-ai/arouter-go`                 |
| **狀態**       | 穩定版                                                |
| **最低 Go 版本** | 1.21+                                              |
| **授權條款**     | MIT                                                |
| **原始碼**      | [GitHub](https://github.com/arouter-ai/arouter-go) |

### 功能特性

* 對話補全（單次及串流）
* 多 provider 模型路由
* key 管理（建立、列出、更新、刪除）
* Provider 代理，支援直接存取上游
* 結構化錯誤處理，內建哨兵錯誤
* 可設定逾時時間及自訂 HTTP 客戶端

### 安裝

```bash theme={null}
go get github.com/arouter-ai/arouter-go
```

### 快速範例

```go theme={null}
import arouter "github.com/arouter-ai/arouter-go"

client := arouter.NewClient("https://api.arouter.ai", "lr_live_xxxx")

resp, err := client.ChatCompletion(ctx, arouter.ChatCompletionRequest{
    Model:    "openai/gpt-5.4",
    Messages: []arouter.Message{{Role: "user", Content: "Hello!"}},
})
```

<Card title="Go SDK 完整文件" icon="book" href="/zh-Hant/sdks/go">
  查看完整 API 參考、串流範例、key 管理和錯誤處理。
</Card>

***

## Node.js SDK（預覽版）

TypeScript 優先的 SDK，支援對話補全、串流、key 管理和用量追蹤。

|          |                                                      |
| -------- | ---------------------------------------------------- |
| **套件名稱** | `@arouter/sdk`                                       |
| **狀態**   | 預覽版（v0.1.0）                                          |
| **執行環境** | Node.js 18+                                          |
| **授權條款** | MIT                                                  |
| **原始碼**  | [GitHub](https://github.com/arouter-ai/arouter-node) |

### 功能特性

* 對話補全（單次及串流）
* 完整 TypeScript 型別定義
* key 管理
* 用量追蹤與分析
* Provider 代理支援

### 安裝

```bash theme={null}
npm install @arouter/sdk
```

### 快速範例

```typescript theme={null}
import { ARouter } from "@arouter/sdk";

const router = new ARouter({
  apiKey: "lr_live_xxxx",
  baseURL: "https://api.arouter.ai",
});

const response = await router.chatCompletion({
  model: "openai/gpt-5.4",
  messages: [{ role: "user", content: "Hello!" }],
});
```

<Card title="Node.js SDK 完整文件" icon="book" href="/zh-Hant/sdks/node">
  查看完整 API 參考，包括 OpenAI/Anthropic SDK 相容性指南。
</Card>

***

## 第三方 SDK 相容性

無需 ARouter SDK 即可快速上手。ARouter 與現有 provider SDK 完全相容：

| SDK           | 語言      | 安裝                                | 文件                                         |
| ------------- | ------- | --------------------------------- | ------------------------------------------ |
| OpenAI SDK    | Python  | `pip install openai`              | [指南 →](/zh-Hant/sdks/python)               |
| OpenAI SDK    | Node.js | `npm install openai`              | [指南 →](/zh-Hant/sdks/node)                 |
| Anthropic SDK | Python  | `pip install anthropic`           | [指南 →](/zh-Hant/sdks/python#anthropic-sdk) |
| Anthropic SDK | Node.js | `npm install @anthropic-ai/sdk`   | [指南 →](/zh-Hant/sdks/node#anthropic-sdk)   |
| Gemini SDK    | Python  | `pip install google-generativeai` | [指南 →](/zh-Hant/sdks/python#gemini-sdk)    |
| cURL          | 任意      | 內建                                | [指南 →](/zh-Hant/sdks/curl)                 |

<Tip>
  只需將 `base_url` 改為 `https://api.arouter.ai` 並設定您的 ARouter API key，所有現有 SDK 程式碼無需修改即可正常運作。
</Tip>