> ## 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、Anthropic、Google、DeepSeek、xAI などのプロバイダーが提供する世界トップクラスの AI モデルへのアクセスを、単一の OpenAI 互換 API で提供します。

    管理するのは1つの API key、1つの課金アカウント、1つの統合だけです。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. 最初のリクエストを送信する

    ステップバイステップガイドは[クイックスタート](/jp/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](/jp/guides/billing-and-credits) で確認できます。
  </Accordion>

  <Accordion title="ARouter のリクエスト料金はどのように決まりますか？">
    ARouter は上流プロバイダーの公開推論レートをそのまま適用します。クレジット購入時にプラットフォーム手数料が発生します。

    Token カウントは上流プロバイダーが報告した値と完全に一致し、各レスポンスの `usage` フィールドに反映されます。
  </Accordion>

  <Accordion title="クレジットは有効期限がありますか？">
    課金規約に従い、未使用のクレジットは購入から1年後に失効する場合があります。
  </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"
    ```

    詳細は[モデル](/jp/models)と[プロバイダー](/jp/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`

    完全なリファレンスは[モデルルーティング](/jp/model-routing)をご覧ください。
  </Accordion>

  <Accordion title="ARouter が最適なモデルを自動選択できますか？">
    はい。`model` を `"auto"` に設定すると、ARouter のルーティングサービスがリクエストに最適なモデルを選択します：

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

    レスポンスには常に実際に使用されたモデルを示す `model` フィールドが含まれます。詳細は[モデルルーティング — 自動ルーティング](/jp/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 はモデルを順番に評価し、最初の成功結果を返します。詳細は[モデルルーティング](/jp/model-routing)をご覧ください。
  </Accordion>
</AccordionGroup>

## API 技術

<AccordionGroup>
  <Accordion title="認証方法は？">
    ARouter は3つの認証方式をサポートしています：

    * **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 の詳細な設定は[認証ガイド](/jp/authentication)をご覧ください。
  </Accordion>

  <Accordion title="レート制限はどのくらいですか？">
    レート制限は API key ごとに適用され、ダッシュボードで設定できます。デフォルトの制限はプランによって異なります。

    レート制限ヘッダーはすべてのレスポンスに含まれます：

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

    詳細は [API リファレンス](/jp/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 リファレンス](/jp/api-reference/introduction)をご覧ください。
  </Accordion>

  <Accordion title="どの入力形式がサポートされていますか？">
    ARouter がサポートする形式：

    * **テキスト**：すべてのモデル
    * **画像**：ビジョン対応モデル（URL または base64）
    * **PDF**：Anthropic Claude と Google Gemini

    詳細は[マルチモーダル](/jp/guides/features/multimodal)をご覧ください。
  </Accordion>

  <Accordion title="ARouter はストリーミングをサポートしていますか？">
    はい。リクエストに `stream: true` を設定してください。ARouter はすべてのプロバイダーで Server-Sent Events (SSE) ストリーミングをサポートしています。

    SSE 形式、エラーハンドリング、キャンセルを含む完全なガイドは[ストリーミング](/jp/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](/jp/sdks/overview) セクションをご覧ください。
  </Accordion>
</AccordionGroup>

## プライバシーとデータ

<AccordionGroup>
  <Accordion title="ARouter はプロンプトを保存しますか？">
    ARouter はデフォルトでプロンプトの内容を保存しません。リクエストボディは上流プロバイダーに転送され、ARouter には保持されません。

    使用量メタデータ（token カウント、モデル、タイムスタンプ、コスト）は課金と分析のために保存されます。

    完全なポリシーは[データ収集](/jp/guides/privacy/data-collection)をご覧ください。
  </Accordion>

  <Accordion title="どのプロバイダーが私のデータを見ますか？">
    お客様の具体的なリクエストを処理する上流プロバイダーのみがプロンプトの内容を見ることができます。`model` フィールドで選択したプロバイダーがリクエストを処理します。ARouter は透過的なプロキシとして機能します。

    上流プロバイダーのデータポリシーの詳細は[プロバイダーロギング](/jp/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` を使用します。[プロバイダールーティング — データ収集ポリシー](/jp/provider-routing#data-collection-policy)をご覧ください。
  </Accordion>

  <Accordion title="ARouter はゼロデータリテンション (ZDR) をサポートしていますか？">
    はい。リクエストに `provider.zdr: true` を設定すると、ゼロデータリテンション契約を持つプロバイダーへのルーティングに制限されます。[プロバイダールーティング](/jp/provider-routing#zero-data-retention-zdr)をご覧ください。
  </Accordion>
</AccordionGroup>

## モデルとプロバイダー

<AccordionGroup>
  <Accordion title=":nitro、:floor、:free などのモデルバリアントとは？">
    モデル ID にサフィックスを追加することでルーティング動作を変更できます：

    * `:nitro` — 最高スループットのインスタンスにルーティング
    * `:floor` — 最低コストのインスタンスにルーティング
    * `:free` — 無料枠インスタンスを使用（レート制限あり）
    * `:thinking` — 拡張 Chain-of-Thought 推論を有効化
    * `:extended` — より大きなコンテキストウィンドウのバージョンを使用

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

    完全なリファレンスは[モデルバリアント](/jp/guides/features/model-variants)をご覧ください。
  </Accordion>

  <Accordion title="ARouter は画像と PDF をサポートしていますか？">
    はい。`content` 配列にテキストと一緒に画像 URL または base64 エンコードされた画像を渡してください。PDF は Anthropic Claude と Google Gemini がサポートしています。

    ```json theme={null}
    {
      "model": "openai/gpt-5.4",
      "messages": [{
        "role": "user",
        "content": [
          {"type": "text", "text": "この画像には何が映っていますか？"},
          {"type": "image_url", "image_url": {"url": "https://..."}}
        ]
      }]
    }
    ```

    例は[マルチモーダル](/jp/guides/features/multimodal)をご覧ください。
  </Accordion>

  <Accordion title="ARouter はツール呼び出しをサポートしていますか？">
    はい。ARouter は OpenAI のツール呼び出し標準を使用して、すべての主要プロバイダーでツール/関数呼び出しをサポートしています。リクエストに `tools` と `tool_choice` を渡してください。

    完全なガイドは[ツール呼び出し](/jp/guides/features/tool-calling)をご覧ください。
  </Accordion>

  <Accordion title="ARouter は構造化出力 / JSON モードをサポートしていますか？">
    はい。有効な JSON 出力には `response_format: {"type": "json_object"}` を、スキーマ制約付き出力には `response_format: {"type": "json_schema", "json_schema": {...}}` を使用してください。

    詳細は[構造化出力](/jp/guides/features/structured-outputs)をご覧ください。
  </Accordion>

  <Accordion title="ARouter はプロンプトキャッシングをサポートしていますか？">
    はい。OpenAI、DeepSeek、xAI、Groq モデルはプロンプトキャッシングを自動的にサポートしています。Anthropic では明示的なキャッシングのために `cache_control` ブロックを使用します。Google Gemini は自動と明示的キャッシングの両方をサポートしています。

    完全なガイドは[プロンプトキャッシング](/jp/guides/features/prompt-caching)をご覧ください。
  </Accordion>
</AccordionGroup>

## アカウント管理

<AccordionGroup>
  <Accordion title="API key に利用上限を設定できますか？">
    はい。API key の作成または更新時に `spending_limit` を設定することで、そのキーの利用上限を設定できます：

    ```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 管理](/jp/guides/key-management)をご覧ください。
  </Accordion>

  <Accordion title="key がアクセスできるプロバイダーを制限するには？">
    key 作成時に `allowed_providers` を設定します：

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

    詳細は [Key 管理](/jp/guides/key-management)をご覧ください。
  </Accordion>

  <Accordion title="複数の API key を持てますか？">
    はい。異なる環境、サービス、用途ごとに複数の API key を作成できます。各 key は独立した利用上限、プロバイダー制限、使用量追跡を持ちます。

    [ダッシュボード](https://arouter.ai/keys)または [Key 管理 API](/jp/api-reference/keys/create-key) で key を管理してください。
  </Accordion>

  <Accordion title="アプリケーション内でユーザーごとに使用量を追跡できますか？">
    はい。各リクエストにエンドユーザーの不透明な識別子を含む `user` フィールドを渡してください。その後、アクティビティエクスポートでユーザーごとの使用量が確認できます。

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

    詳細は[ユーザー追跡](/jp/guides/administration/user-tracking)をご覧ください。
  </Accordion>

  <Accordion title="複数人でアカウントを共有できますか？">
    はい。[組織管理](/jp/guides/administration/organization-management)を使用して共有組織を作成し、チームメンバーを招待し、共有クレジットを管理し、権限を制御できます。
  </Accordion>
</AccordionGroup>