跳转到主要内容

​
快速入门

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": [...]}
详情请参阅用户追踪。
可以。使用组织管理创建共享组织、邀请团队成员、管理共享积分并控制权限。