> ## 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 的常见问题 — 身份验证、计费、模型、速率限制等。

## 快速入门

<AccordionGroup>
  <Accordion title="什么是 ARouter？">
    ARouter 是一个统一的 API 网关，通过单一的 OpenAI 兼容 API，为您提供访问全球领先 AI 模型的能力，包括 OpenAI、Anthropic、Google、DeepSeek、xAI 等众多提供商。

    您只需管理一个 API key、一个计费账户和一套集成方案。ARouter 透明地处理路由、身份验证、故障转移和用量追踪。
  </Accordion>

  <Accordion title="如何开始使用？">
    1. 在 [https://api.arouter.ai](https://api.arouter.ai) 创建账户
    2. 在控制台生成 API key
    3. 在任意 OpenAI 兼容客户端中将 base URL 设置为 `https://api.arouter.ai/v1`
    4. 发送您的第一个请求

    请参阅 [快速入门](/zh/quickstart) 获取分步指南。
  </Accordion>

  <Accordion title="如何获取支持？">
    * **GitHub Issues**：[github.com/arouter-ai](https://github.com/arouter-ai)
    * **邮件**：在控制台中查看联系方式
    * **文档**：您正在阅读的就是！
  </Accordion>
</AccordionGroup>

## 计费

<AccordionGroup>
  <Accordion title="如何收费？">
    ARouter 使用积分制。您预先购买积分，每次请求根据 token 用量消耗积分。

    您可以在[控制台](https://arouter.ai/billing)或通过 [API](/zh/guides/billing-and-credits) 查看余额和交易记录。
  </Accordion>

  <Accordion title="ARouter 如何对请求定价？">
    ARouter 按照上游提供商公布的推理费率透传计费，购买积分时会收取平台服务费。

    Token 计数与上游提供商报告的完全一致，并反映在每次响应的 `usage` 字段中。
  </Accordion>

  <Accordion title="积分会过期吗？">
    根据计费条款，未使用的积分可能在购买后一年到期。
  </Accordion>

  <Accordion title="退款政策是什么？">
    未使用积分的退款申请须在购买后 24 小时内提交。超过此时限后，未使用的积分将不予退款。

    平台服务费不可退款，加密货币支付不可退款。
  </Accordion>

  <Accordion title="BYOK 是否需要收费？">
    是的。首先有每月免费额度，超出后将产生少量 ARouter 平台费，推理费用则通过您自己的提供商 key 计费。
  </Accordion>

  <Accordion title="如何查询余额？">
    通过 API：

    ```bash theme={null}
    curl https://api.arouter.ai/api/v1/balance \
      -H "Authorization: Bearer lr_live_xxxx"
    ```

    或在控制台 [https://arouter.ai/billing](https://arouter.ai/billing) 查看。
  </Accordion>

  <Accordion title="积分还未到账，怎么办？">
    如果您已完成购买但余额未立即更新，请等待一段时间以便支付结算完成。

    若扣款成功但积分仍未到账，请通过控制台联系支持团队并提供购买详情，以便追踪付款。
  </Accordion>

  <Accordion title="支持哪些支付方式？">
    ARouter 支持在控制台通过银行卡购买积分，以及通过 x402 等支持的支付流程进行加密货币充值。
  </Accordion>

  <Accordion title="是否有免费套餐？">
    如果您的账户包含免费积分或促销用量，这些请求最好视为测试容量，而非生产容量。账户级和套餐级限制仍然适用。
  </Accordion>
</AccordionGroup>

## 模型

<AccordionGroup>
  <Accordion title="支持哪些模型？">
    ARouter 支持来自 OpenAI、Anthropic、Google、DeepSeek、xAI、Mistral、Meta、Qwen、MiniMax、Groq、Kimi、Cohere、NVIDIA 和 Dashscope 的模型。

    使用 `GET /v1/models` 查看账户可用的完整列表：

    ```bash theme={null}
    curl https://api.arouter.ai/v1/models \
      -H "Authorization: Bearer lr_live_xxxx"
    ```

    详情请参阅[模型](/zh/models)和[提供商](/zh/providers)。
  </Accordion>

  <Accordion title="如何指定要使用的模型？">
    在 `model` 字段中使用 `provider/model` 格式：

    * `openai/gpt-5.4`
    * `anthropic/claude-sonnet-4.6`
    * `google/gemini-2.5-flash`
    * `deepseek/deepseek-v3.2`

    完整参考请参阅[模型路由](/zh/model-routing)。
  </Accordion>

  <Accordion title="ARouter 能自动选择最佳模型吗？">
    可以。将 `model` 设置为 `"auto"`，ARouter 的路由服务将为您的请求选择最佳可用模型：

    ```json theme={null}
    {
      "model": "auto",
      "messages": [{ "role": "user", "content": "Hello!" }]
    }
    ```

    响应中始终包含 `model` 字段，显示实际使用的模型。详情请参阅[模型路由 — 自动路由](/zh/model-routing#auto-routing)。
  </Accordion>

  <Accordion title="可以提供多个候选模型吗？">
    可以。将 `models` 数组与 `route` 一起使用：

    ```json theme={null}
    {
      "models": ["anthropic/claude-opus-4.5", "openai/gpt-5.4"],
      "route": "fallback",
      "messages": [...]
    }
    ```

    ARouter 按顺序评估模型并返回第一个成功结果。详情请参阅[模型路由](/zh/model-routing)。
  </Accordion>
</AccordionGroup>

## API 技术

<AccordionGroup>
  <Accordion title="如何进行身份验证？">
    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 的详细设置请参阅[身份验证指南](/zh/authentication)。
  </Accordion>

  <Accordion title="速率限制是多少？">
    速率限制按 API key 应用，可在控制台配置。默认限制取决于您的套餐。

    每次响应均包含速率限制头：

    * `X-RateLimit-Limit`
    * `X-RateLimit-Remaining`
    * `X-RateLimit-Reset`

    详情请参阅 [API 参考](/zh/api-reference/introduction)。
  </Accordion>

  <Accordion title="有哪些可用端点？">
    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 参考](/zh/api-reference/introduction)。
  </Accordion>

  <Accordion title="支持哪些输入格式？">
    ARouter 支持：

    * **文本**：所有模型
    * **图像**：支持视觉的模型（URL 或 base64）
    * **PDF**：Anthropic Claude 和 Google Gemini

    详情请参阅[多模态](/zh/guides/features/multimodal)。
  </Accordion>

  <Accordion title="ARouter 支持流式传输吗？">
    支持。在请求中设置 `stream: true`。ARouter 支持所有提供商的 Server-Sent Events (SSE) 流式传输。

    包含 SSE 格式、错误处理和取消的完整指南，请参阅[流式传输](/zh/guides/streaming)。
  </Accordion>

  <Accordion title="支持哪些 SDK？">
    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](/zh/sdks/overview) 部分。
  </Accordion>
</AccordionGroup>

## 隐私与数据

<AccordionGroup>
  <Accordion title="ARouter 会存储我的提示词吗？">
    ARouter 默认不存储提示词内容。请求体会直接转发给上游提供商，ARouter 不会保留。

    用量元数据（token 计数、模型、时间戳、费用）会为计费和分析目的而存储。

    完整政策请参阅[数据收集](/zh/guides/privacy/data-collection)。
  </Accordion>

  <Accordion title="哪些提供商能看到我的数据？">
    只有处理您具体请求的上游提供商才能看到您的提示词内容。您通过 `model` 字段选择的提供商会处理您的请求。ARouter 作为透明代理运行。

    上游提供商数据政策的详情，请参阅[提供商日志](/zh/guides/privacy/provider-logging)。
  </Accordion>

  <Accordion title="能防止提供商用我的数据训练模型吗？">
    使用 `provider.data_collection: "deny"` 将路由限制到不使用请求数据进行模型训练的提供商：

    ```json theme={null}
    {
      "model": "anthropic/claude-sonnet-4.6",
      "provider": {"data_collection": "deny"}
    }
    ```

    或使用 `provider.zdr: true` 强制执行零数据留存。请参阅[提供商路由 — 数据收集政策](/zh/provider-routing#data-collection-policy)。
  </Accordion>

  <Accordion title="ARouter 支持零数据留存 (ZDR) 吗？">
    支持。在请求中设置 `provider.zdr: true` 可将路由限制到具有零数据留存协议的提供商。请参阅[提供商路由](/zh/provider-routing#zero-data-retention-zdr)。
  </Accordion>
</AccordionGroup>

## 模型与提供商

<AccordionGroup>
  <Accordion title="什么是 :nitro、:floor、:free 等模型变体？">
    您可以在任意模型 ID 后附加后缀来改变路由行为：

    * `:nitro` — 路由到吞吐量最高的实例
    * `:floor` — 路由到成本最低的实例
    * `:free` — 使用免费套餐实例（适用速率限制）
    * `:thinking` — 启用扩展的链式思维推理
    * `:extended` — 使用具有更大上下文窗口的版本

    ```json theme={null}
    {"model": "openai/gpt-5.4:nitro"}
    ```

    完整参考请参阅[模型变体](/zh/guides/features/model-variants)。
  </Accordion>

  <Accordion title="ARouter 支持图像和 PDF 吗？">
    支持。在 `content` 数组中将图像 URL 或 base64 编码的图像与文本一起传递。Anthropic Claude 和 Google Gemini 支持 PDF。

    ```json theme={null}
    {
      "model": "openai/gpt-5.4",
      "messages": [{
        "role": "user",
        "content": [
          {"type": "text", "text": "这张图片里有什么？"},
          {"type": "image_url", "image_url": {"url": "https://..."}}
        ]
      }]
    }
    ```

    示例请参阅[多模态](/zh/guides/features/multimodal)。
  </Accordion>

  <Accordion title="ARouter 支持工具调用吗？">
    支持。ARouter 使用 OpenAI 工具调用标准，为所有主流提供商提供工具/函数调用支持。在请求中传递 `tools` 和 `tool_choice`。

    完整指南请参阅[工具调用](/zh/guides/features/tool-calling)。
  </Accordion>

  <Accordion title="ARouter 支持结构化输出 / JSON 模式吗？">
    支持。使用 `response_format: {"type": "json_object"}` 获取有效的 JSON 输出，或使用 `response_format: {"type": "json_schema", "json_schema": {...}}` 获取符合 schema 约束的输出。

    详情请参阅[结构化输出](/zh/guides/features/structured-outputs)。
  </Accordion>

  <Accordion title="ARouter 支持提示词缓存吗？">
    支持。OpenAI、DeepSeek、xAI 和 Groq 模型自动支持提示词缓存。对于 Anthropic，使用 `cache_control` 块进行显式缓存。Google Gemini 同时支持自动和显式缓存。

    完整指南请参阅[提示词缓存](/zh/guides/features/prompt-caching)。
  </Accordion>
</AccordionGroup>

## 账户管理

<AccordionGroup>
  <Accordion title="可以为 API key 设置消费限额吗？">
    可以。创建或更新 API key 时，设置 `spending_limit` 来限制该 key 的消费上限：

    ```bash theme={null}
    curl -X POST https://api.arouter.ai/v1/keys \
      -H "Authorization: Bearer lr_live_xxxx" \
      -d '{"name": "production", "spending_limit": 100.00}'
    ```

    详情请参阅 [Key 管理](/zh/guides/key-management)。
  </Accordion>

  <Accordion title="如何限制 key 可访问的提供商？">
    创建 key 时设置 `allowed_providers`：

    ```json theme={null}
    {
      "name": "openai-only-key",
      "allowed_providers": ["openai", "anthropic"]
    }
    ```

    详情请参阅 [Key 管理](/zh/guides/key-management)。
  </Accordion>

  <Accordion title="可以拥有多个 API key 吗？">
    可以。您可以为不同的环境、服务或用途创建多个 API key。每个 key 具有独立的消费限额、提供商限制和用量追踪。

    在[控制台](https://arouter.ai/keys)或通过 [Key 管理 API](/zh/api-reference/keys/create-key) 管理 key。
  </Accordion>

  <Accordion title="可以在应用中按用户追踪用量吗？">
    可以。在每个请求中传递 `user` 字段，使用不透明的终端用户标识符。之后可在活动导出中按用户查看用量。

    ```json theme={null}
    {"model": "openai/gpt-5.4", "user": "user_12345", "messages": [...]}
    ```

    详情请参阅[用户追踪](/zh/guides/administration/user-tracking)。
  </Accordion>

  <Accordion title="多人可以共享一个账户吗？">
    可以。使用[组织管理](/zh/guides/administration/organization-management)创建共享组织、邀请团队成员、管理共享积分并控制权限。
  </Accordion>
</AccordionGroup>