跳轉到主要內容

​
快速入門

ARouter 是一個統一的 API 閘道，透過單一的 OpenAI 相容 API，為您提供存取全球領先 AI 模型的能力，包括 OpenAI、Anthropic、Google、DeepSeek、xAI 等眾多提供商。您只需管理一個 API key、一個計費帳戶和一套整合方案。ARouter 透明地處理路由、身分驗證、故障轉移和用量追蹤。
  1. 在 https://api.arouter.ai 建立帳戶
  2. 在控制台產生 API key
  3. 在任意 OpenAI 相容客戶端中將 base URL 設定為 https://api.arouter.ai/v1
  4. 發送您的第一個請求
請參閱快速入門以取得逐步指南。
  • GitHub Issues：github.com/arouter-ai
  • 電子郵件：在控制台中查看聯絡方式
  • 文件：您正在閱讀的就是！

​
計費

ARouter 使用點數制。您預先購買點數，每次請求根據 token 用量消耗點數。您可以在控制台或透過 API 查看餘額和交易記錄。
ARouter 按照上游提供商公佈的推理費率透傳計費，購買點數時會收取平台服務費。Token 計數與上游提供商回報的完全一致，並反映在每次回應的 usage 欄位中。
根據計費條款，未使用的點數可能在購買後一年到期。
未使用點數的退款申請須在購買後 24 小時內提交。超過此時限後，未使用的點數將不予退款。平台服務費不可退款，加密貨幣支付不可退款。
是的。首先有每月免費額度，超出後將產生少量 ARouter 平台費，推理費用則透過您自己的提供商 key 計費。
透過 API：
curl https://api.arouter.ai/api/v1/balance \
  -H "Authorization: Bearer lr_live_xxxx"
或在控制台 https://arouter.ai/billing 查看。
如果您已完成購買但餘額未立即更新，請等待一段時間以便支付結算完成。若扣款成功但點數仍未到帳，請透過控制台聯絡支援團隊並提供購買詳情，以便追蹤付款。
ARouter 支援在控制台透過銀行卡購買點數，以及透過 x402 等支援的支付流程進行加密貨幣儲值。
如果您的帳戶包含免費點數或促銷用量，這些請求最好視為測試容量，而非生產容量。帳戶級和方案級限制仍然適用。

​
模型

ARouter 支援來自 OpenAI、Anthropic、Google、DeepSeek、xAI、Mistral、Meta、Qwen、MiniMax、Groq、Kimi、Cohere、NVIDIA 和 Dashscope 的模型。使用 GET /v1/models 查看帳戶可用的完整列表：
curl https://api.arouter.ai/v1/models \
  -H "Authorization: Bearer lr_live_xxxx"
詳情請參閱模型和提供商。
在 model 欄位中使用 provider/model 格式：
  • openai/gpt-5.4
  • anthropic/claude-sonnet-4.6
  • google/gemini-2.5-flash
  • deepseek/deepseek-v3.2
完整參考請參閱模型路由。
可以。將 model 設定為 "auto"，ARouter 的路由服務將為您的請求選擇最佳可用模型：
{
  "model": "auto",
  "messages": [{ "role": "user", "content": "Hello!" }]
}
回應中始終包含 model 欄位，顯示實際使用的模型。詳情請參閱模型路由 — 自動路由。
可以。將 models 陣列與 route 一起使用：
{
  "models": ["anthropic/claude-opus-4.5", "openai/gpt-5.4"],
  "route": "fallback",
  "messages": [...]
}
ARouter 按順序評估模型並回傳第一個成功結果。詳情請參閱模型路由。

​
API 技術

ARouter 支援三種身分驗證方式：
  • Bearer token：Authorization: Bearer lr_live_xxxx（OpenAI SDK、fetch）
  • API Key header：X-Api-Key: lr_live_xxxx（Anthropic SDK）
  • 查詢參數：?key=lr_live_xxxx（Gemini SDK）
每種 SDK 的詳細設定請參閱身分驗證指南。
速率限制按 API key 套用，可在控制台設定。預設限制取決於您的方案。每次回應均包含速率限制標頭：
  • X-RateLimit-Limit
  • X-RateLimit-Remaining
  • X-RateLimit-Reset
詳情請參閱 API 參考。
ARouter 提供以下端點：
  • /v1/chat/completions — OpenAI 相容聊天
  • /v1/embeddings — OpenAI 相容 embeddings
  • /v1/models — 列出可用模型
  • /v1/messages — Anthropic 原生
  • /v1beta/models/{model}:generateContent — Gemini 原生
  • /api/v1/balance — 帳戶餘額
  • /api/v1/transactions — 交易記錄
  • /api/v1/keys — API key 管理
  • /{provider}/{path} — 提供商代理
完整列表請參閱 API 參考。
ARouter 支援：
  • 文字：所有模型
  • 圖片：支援視覺的模型（URL 或 base64）
  • PDF：Anthropic Claude 和 Google Gemini
詳情請參閱多模態。
支援。在請求中設定 stream: true。ARouter 支援所有提供商的 Server-Sent Events (SSE) 串流傳輸。包含 SSE 格式、錯誤處理和取消的完整指南，請參閱串流傳輸。
ARouter 相容以下 SDK：
  • Python：OpenAI SDK（pip install openai）
  • Node.js / TypeScript：OpenAI SDK（npm install openai）
  • Go：ARouter Go SDK（go get github.com/arouter-ai/arouter-go）
  • Anthropic SDK：Python 和 Node.js
  • Google Gemini SDK：Python
  • 任意 HTTP 客戶端：透過 cURL、fetch 等
設定指南請參閱 SDK 部分。

​
隱私與資料

ARouter 預設不儲存提示詞內容。請求體會直接轉送給上游提供商，ARouter 不會保留。用量元資料（token 計數、模型、時間戳記、費用）會為計費和分析目的而儲存。完整政策請參閱資料收集。
只有處理您具體請求的上游提供商才能看到您的提示詞內容。您透過 model 欄位選擇的提供商會處理您的請求。ARouter 作為透明代理運行。上游提供商資料政策的詳情，請參閱提供商日誌。
使用 provider.data_collection: "deny" 將路由限制到不使用請求資料進行模型訓練的提供商：
{
  "model": "anthropic/claude-sonnet-4.6",
  "provider": {"data_collection": "deny"}
}
或使用 provider.zdr: true 強制執行零資料留存。請參閱提供商路由 — 資料收集政策。
支援。在請求中設定 provider.zdr: true 可將路由限制到具有零資料留存協議的提供商。請參閱提供商路由。

​
模型與提供商

您可以在任意模型 ID 後附加後綴來改變路由行為：
  • :nitro — 路由到吞吐量最高的實例
  • :floor — 路由到成本最低的實例
  • :free — 使用免費方案實例（適用速率限制）
  • :thinking — 啟用擴展的鏈式思維推理
  • :extended — 使用具有更大上下文視窗的版本
{"model": "openai/gpt-5.4:nitro"}
完整參考請參閱模型變體。
支援。在 content 陣列中將圖片 URL 或 base64 編碼的圖片與文字一起傳遞。Anthropic Claude 和 Google Gemini 支援 PDF。
{
  "model": "openai/gpt-5.4",
  "messages": [{
    "role": "user",
    "content": [
      {"type": "text", "text": "這張圖片裡有什麼？"},
      {"type": "image_url", "image_url": {"url": "https://..."}}
    ]
  }]
}
範例請參閱多模態。
支援。ARouter 使用 OpenAI 工具呼叫標準，為所有主流提供商提供工具/函數呼叫支援。在請求中傳遞 tools 和 tool_choice。完整指南請參閱工具呼叫。
支援。使用 response_format: {"type": "json_object"} 取得有效的 JSON 輸出，或使用 response_format: {"type": "json_schema", "json_schema": {...}} 取得符合 schema 約束的輸出。詳情請參閱結構化輸出。
支援。OpenAI、DeepSeek、xAI 和 Groq 模型自動支援提示詞快取。對於 Anthropic，使用 cache_control 區塊進行明確快取。Google Gemini 同時支援自動和明確快取。完整指南請參閱提示詞快取。

​
帳戶管理

可以。建立或更新 API key 時，設定 spending_limit 來限制該 key 的消費上限：
curl -X POST https://api.arouter.ai/v1/keys \
  -H "Authorization: Bearer lr_live_xxxx" \
  -d '{"name": "production", "spending_limit": 100.00}'
詳情請參閱 Key 管理。
建立 key 時設定 allowed_providers：
{
  "name": "openai-only-key",
  "allowed_providers": ["openai", "anthropic"]
}
詳情請參閱 Key 管理。
可以。您可以為不同的環境、服務或用途建立多個 API key。每個 key 具有獨立的消費上限、提供商限制和用量追蹤。在控制台或透過 Key 管理 API 管理 key。
可以。在每個請求中傳遞 user 欄位，使用不透明的終端使用者識別碼。之後可在活動匯出中按使用者查看用量。
{"model": "openai/gpt-5.4", "user": "user_12345", "messages": [...]}
詳情請參閱使用者追蹤。
可以。使用組織管理建立共用組織、邀請團隊成員、管理共用點數並控制權限。