跳转到主要内容
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
OpenAIopenaihttps://api.openai.com
Anthropicanthropichttps://api.anthropic.com
Google Geminigooglehttps://generativelanguage.googleapis.com
DeepSeekdeepseekhttps://api.deepseek.com
xAIxaihttps://api.x.ai
Kimi (Moonshot)kimihttps://api.moonshot.cn
MiniMaxminimaxhttps://api.minimax.chat
Mistralmistralhttps://api.mistral.ai
Groqgroqhttps://api.groq.com
Coherecoherehttps://api.cohere.com
NVIDIAnvidiahttps://integrate.api.nvidia.com
Dashscope(阿里巴巴)dashscopehttps://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 请求头会自动注入,无需手动添加。