> ## 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，透過統一 API 觸達使用該平台的開發者。

ARouter 透過單一 API 為開發者提供數百個模型的存取。如果您經營 AI 模型或推理服務，與 ARouter 整合可讓您直接觸達那些已在 ARouter API 上建構應用程式的開發者——無需他們更改程式碼。

## 為什麼與 ARouter 合作

* **即時觸達開發者** — 使用 ARouter 的開發者無需註冊獨立帳戶或 SDK 即可立即存取您的模型
* **零摩擦切換** — 開發者只需修改一個字串（`model: "yourprovider/your-model"`）即可試用您的模型
* **流量增長** — 您的模型出現在 ARouter 模型目錄中，並可透過統一的 `/v1/models` 端點存取
* **透明定價** — 您設定價格；ARouter 向最終用戶準確呈現

***

## 整合要求

要與 ARouter 整合，您的 API 必須提供：

### 1. OpenAI 相容端點

ARouter 使用 OpenAI API 格式進行請求路由。您的端點應接受：

```
POST /v1/chat/completions
```

使用標準 OpenAI 請求/回應格式，包含透過 Server-Sent Events（SSE）的串流傳輸。

### 2. 模型 ID

您公開的每個模型應具有唯一且穩定的模型 ID。ARouter 使用 `provider/model` 命名慣例：

```
yourprovider/your-model-name
```

### 3. 使用量回報

您的回應必須包含帶有準確 Token 計數的 `usage` 物件：

```json theme={null}
{
  "usage": {
    "prompt_tokens": 100,
    "completion_tokens": 50,
    "total_tokens": 150
  }
}
```

***

## ARouter 負責處理的內容

整合後，ARouter 將為您的用戶透明處理以下事項：

| 職責         | ARouter       | 您的 API    |
| ---------- | ------------- | --------- |
| API Key 管理 | 使用注入的憑證路由請求   | 驗證憑證      |
| 服務商健康監控    | 熔斷器 + 金鑰池健康檢查 | 回應請求      |
| 速率限制       | 追蹤每個金鑰和用戶的限制  | 執行您的速率限制  |
| 使用量記錄      | 記錄 Token 和成本  | 在回應中回傳使用量 |
| 串流傳輸       | 透傳 SSE 流      | 產生 SSE 流  |
| 錯誤規範化      | 標準化錯誤代碼       | 回傳原生錯誤    |

***

## 模型元資料

ARouter 透過 `/v1/models` 端點向開發者提供豐富的模型元資料。您可以為每個模型提供：

```json theme={null}
{
  "id": "yourprovider/your-model",
  "name": "Your Model Name",
  "description": "A brief description of capabilities.",
  "context_length": 128000,
  "architecture": {
    "input_modalities": ["text", "image"],
    "output_modalities": ["text"],
    "tokenizer": "cl100k_base",
    "instruct_type": "chatml"
  },
  "pricing": {
    "prompt": "0.000002",
    "completion": "0.000006"
  },
  "supported_parameters": ["tools", "temperature", "max_tokens", "structured_outputs"]
}
```

***

## 支援的端點類型

| 端點類型                    | 說明                                |
| ----------------------- | --------------------------------- |
| OpenAI Chat Completions | 支援串流傳輸的標準聊天                       |
| OpenAI Embeddings       | 透過 `/v1/embeddings` 的文字嵌入         |
| Anthropic Messages      | 原生 Anthropic 訊息格式                 |
| Gemini GenerateContent  | 原生 Gemini 格式                      |
| 自訂端點                    | 透過服務商代理（`/{yourprovider}/{path}`） |

***

## 服務商代理

開發者也可以透過 ARouter 的服務商代理直接向您的 API 發送請求，完全繞過模型路由層：

```
POST /{yourprovider}/v1/chat/completions
```

這對於希望使用您的原生 API 格式同時仍受益於 ARouter 的金鑰管理和計費功能的開發者非常有用。

***

## 快速開始

將您的模型整合到 ARouter：

1. **聯絡我們**，發送郵件至 [providers@arouter.ai](mailto:providers@arouter.ai)，附上您的 API 文件和模型目錄
2. **提供憑證** — ARouter 使用的 API Key 或 OAuth 憑證
3. **檢查模型元資料** — 確認模型 ID、定價、上下文長度和支援的參數
4. **測試整合** — ARouter 團隊驗證路由和回應格式相容性
5. **上線** — 您的模型將出現在 ARouter 目錄中，立即可存取

***

## 資料處理

ARouter 尊重您的資料政策：

* 請求/回應資料**預設不儲存** — 參閱[資料採集](/zh-Hant/guides/privacy/data-collection)
* 您可以指定您的端點是否支援**零資料保留（ZDR）**
* 開發者可以按請求選擇是否啟用資料採集

***

## 定價與收益

ARouter 向開發者準確呈現您的定價。您設定每 Token 的價格；ARouter 不對標準路由添加任何加價。

開發者透過 ARouter 計費，您將按約定費率獲得補償。商務條款請聯絡 [providers@arouter.ai](mailto:providers@arouter.ai)。