ARouter 的服務商代理讓您使用 ARouter API Key 作為驗證,將請求直接轉發到任何受支援服務商的原生 API。無需為每個服務商個別管理 API Key。
POST /{provider}/{path}
GET /{provider}/{path}
其中 {provider} 是服務商的識別碼,{path} 是服務商的原生 API 路徑。
何時使用服務商代理
| 使用情境 | 建議方式 |
|---|
| 標準 LLM 聊天補全 | 使用 provider/model 格式的 /v1/chat/completions |
| 服務商特有功能(如 Anthropic Batches、Gemini 快取內容) | /{provider}/{path} 代理 |
| 原生串流格式 | /{provider}/{path} 代理 |
| ARouter 架構中不包含的服務商特定參數 | /{provider}/{path} 代理 |
支援的服務商
| 服務商 | 識別碼 | 基礎 URL |
|---|
| OpenAI | openai | https://api.openai.com |
| Anthropic | anthropic | https://api.anthropic.com |
| Google Gemini | google | https://generativelanguage.googleapis.com |
| DeepSeek | deepseek | https://api.deepseek.com |
| xAI | xai | https://api.x.ai |
| Kimi (Moonshot) | kimi | https://api.moonshot.cn |
| MiniMax | minimax | https://api.minimax.chat |
| Mistral | mistral | https://api.mistral.ai |
| Groq | groq | https://api.groq.com |
| Cohere | cohere | https://api.cohere.com |
| NVIDIA | nvidia | https://integrate.api.nvidia.com |
| Dashscope(阿里巴巴) | dashscope | https://dashscope.aliyuncs.com |
OpenAI — 聊天補全
curl https://api.arouter.ai/openai/v1/chat/completions \
-H "Authorization: Bearer lr_live_xxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.4",
"messages": [{"role": "user", "content": "Hello!"}]
}'
Anthropic — 訊息
curl https://api.arouter.ai/anthropic/v1/messages \
-H "Authorization: Bearer lr_live_xxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4.6",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Hello!"}]
}'
Anthropic — 批次訊息
# 建立批次
curl https://api.arouter.ai/anthropic/v1/messages/batches \
-X POST \
-H "Authorization: Bearer lr_live_xxxx" \
-H "Content-Type: application/json" \
-d '{
"requests": [
{
"custom_id": "request-1",
"params": {
"model": "claude-sonnet-4.6",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Hello!"}]
}
}
]
}'
# 檢查批次狀態
curl https://api.arouter.ai/anthropic/v1/messages/batches/msgbatch_xxx \
-H "Authorization: Bearer lr_live_xxxx"
Google Gemini — 生成內容
curl "https://api.arouter.ai/google/v1beta/models/gemini-2.5-flash:generateContent" \
-X POST \
-H "Authorization: Bearer lr_live_xxxx" \
-H "Content-Type: application/json" \
-d '{
"contents": [
{"role": "user", "parts": [{"text": "Hello!"}]}
]
}'
Google Gemini — 列出模型
curl "https://api.arouter.ai/google/v1beta/models" \
-H "Authorization: Bearer lr_live_xxxx"
DeepSeek — 聊天補全
curl https://api.arouter.ai/deepseek/v1/chat/completions \
-H "Authorization: Bearer lr_live_xxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-v3.2",
"messages": [{"role": "user", "content": "Hello!"}]
}'
注意事項
- 驗證:ARouter 會自動注入服務商的 API Key。您只需使用自己的 ARouter Key。
- 原生格式:請求和回應原樣傳遞 — ARouter 不對其進行轉換。
- 使用量追蹤:Token 使用量仍會記錄到您的 ARouter 帳戶。
- 路徑透傳:
/{provider}/ 之後的所有內容將原封不動地轉發給服務商。
使用服務商代理存取 Anthropic 時,anthropic-version 請求標頭會自動注入,無需手動加入。