> ## 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-Hant/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-Hant/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-Hant/models)和[提供商](/zh-Hant/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-Hant/model-routing)。
  </Accordion>

  <Accordion title="ARouter 能自動選擇最佳模型嗎？">
    可以。將 `model` 設定為 `"auto"`，ARouter 的路由服務將為您的請求選擇最佳可用模型：

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

    回應中始終包含 `model` 欄位，顯示實際使用的模型。詳情請參閱[模型路由 — 自動路由](/zh-Hant/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-Hant/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-Hant/authentication)。
  </Accordion>

  <Accordion title="速率限制是多少？">
    速率限制按 API key 套用，可在控制台設定。預設限制取決於您的方案。

    每次回應均包含速率限制標頭：

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

    詳情請參閱 [API 參考](/zh-Hant/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-Hant/api-reference/introduction)。
  </Accordion>

  <Accordion title="支援哪些輸入格式？">
    ARouter 支援：

    * **文字**：所有模型
    * **圖片**：支援視覺的模型（URL 或 base64）
    * **PDF**：Anthropic Claude 和 Google Gemini

    詳情請參閱[多模態](/zh-Hant/guides/features/multimodal)。
  </Accordion>

  <Accordion title="ARouter 支援串流傳輸嗎？">
    支援。在請求中設定 `stream: true`。ARouter 支援所有提供商的 Server-Sent Events (SSE) 串流傳輸。

    包含 SSE 格式、錯誤處理和取消的完整指南，請參閱[串流傳輸](/zh-Hant/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-Hant/sdks/overview) 部分。
  </Accordion>
</AccordionGroup>

## 隱私與資料

<AccordionGroup>
  <Accordion title="ARouter 會儲存我的提示詞嗎？">
    ARouter 預設不儲存提示詞內容。請求體會直接轉送給上游提供商，ARouter 不會保留。

    用量元資料（token 計數、模型、時間戳記、費用）會為計費和分析目的而儲存。

    完整政策請參閱[資料收集](/zh-Hant/guides/privacy/data-collection)。
  </Accordion>

  <Accordion title="哪些提供商能看到我的資料？">
    只有處理您具體請求的上游提供商才能看到您的提示詞內容。您透過 `model` 欄位選擇的提供商會處理您的請求。ARouter 作為透明代理運行。

    上游提供商資料政策的詳情，請參閱[提供商日誌](/zh-Hant/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-Hant/provider-routing#data-collection-policy)。
  </Accordion>

  <Accordion title="ARouter 支援零資料留存 (ZDR) 嗎？">
    支援。在請求中設定 `provider.zdr: true` 可將路由限制到具有零資料留存協議的提供商。請參閱[提供商路由](/zh-Hant/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-Hant/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-Hant/guides/features/multimodal)。
  </Accordion>

  <Accordion title="ARouter 支援工具呼叫嗎？">
    支援。ARouter 使用 OpenAI 工具呼叫標準，為所有主流提供商提供工具/函數呼叫支援。在請求中傳遞 `tools` 和 `tool_choice`。

    完整指南請參閱[工具呼叫](/zh-Hant/guides/features/tool-calling)。
  </Accordion>

  <Accordion title="ARouter 支援結構化輸出 / JSON 模式嗎？">
    支援。使用 `response_format: {"type": "json_object"}` 取得有效的 JSON 輸出，或使用 `response_format: {"type": "json_schema", "json_schema": {...}}` 取得符合 schema 約束的輸出。

    詳情請參閱[結構化輸出](/zh-Hant/guides/features/structured-outputs)。
  </Accordion>

  <Accordion title="ARouter 支援提示詞快取嗎？">
    支援。OpenAI、DeepSeek、xAI 和 Groq 模型自動支援提示詞快取。對於 Anthropic，使用 `cache_control` 區塊進行明確快取。Google Gemini 同時支援自動和明確快取。

    完整指南請參閱[提示詞快取](/zh-Hant/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-Hant/guides/key-management)。
  </Accordion>

  <Accordion title="如何限制 key 可存取的提供商？">
    建立 key 時設定 `allowed_providers`：

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

    詳情請參閱 [Key 管理](/zh-Hant/guides/key-management)。
  </Accordion>

  <Accordion title="可以擁有多個 API key 嗎？">
    可以。您可以為不同的環境、服務或用途建立多個 API key。每個 key 具有獨立的消費上限、提供商限制和用量追蹤。

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

  <Accordion title="可以在應用中按使用者追蹤用量嗎？">
    可以。在每個請求中傳遞 `user` 欄位，使用不透明的終端使用者識別碼。之後可在活動匯出中按使用者查看用量。

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

    詳情請參閱[使用者追蹤](/zh-Hant/guides/administration/user-tracking)。
  </Accordion>

  <Accordion title="多人可以共用一個帳戶嗎？">
    可以。使用[組織管理](/zh-Hant/guides/administration/organization-management)建立共用組織、邀請團隊成員、管理共用點數並控制權限。
  </Accordion>
</AccordionGroup>