> ## 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 API との認証方法は 4 種類——ユースケースに合ったものを選んでください。

すべての `/v1/*` エンドポイントには認証が必要です。ARouter は 4 つの方式をサポートしています：主要な LLM SDK に対応した 3 つの API key ベースの方式、そして暗号ウォレットを持つ AI エージェント向けのウォレットベース認証です。

## 認証方式

<Tabs>
  <Tab title="Bearer Token">
    **OpenAI SDK**、**DeepSeek SDK**、**Mistral SDK**、およびほとんどの OpenAI 互換クライアントで使用されます。

    ```bash theme={null}
    Authorization: Bearer lr_live_xxxx
    ```

    ```python theme={null}
    from openai import OpenAI

    client = OpenAI(
        base_url="https://api.arouter.ai/v1",
        api_key="lr_live_xxxx",  # Bearer token として送信
    )
    ```
  </Tab>

  <Tab title="X-Api-Key Header">
    **Anthropic SDK** で使用されます。

    ```bash theme={null}
    X-Api-Key: lr_live_xxxx
    ```

    ```python theme={null}
    import anthropic

    client = anthropic.Anthropic(
        base_url="https://api.arouter.ai",
        api_key="lr_live_xxxx",  # X-Api-Key として送信
    )
    ```
  </Tab>

  <Tab title="クエリパラメータ">
    **Google Gemini SDK** で使用されます。

    ```bash theme={null}
    GET /v1beta/models?key=lr_live_xxxx
    ```

    ```python theme={null}
    import google.generativeai as genai

    genai.configure(
        api_key="lr_live_xxxx",  # ?key= パラメータとして送信
        transport="rest",
        client_options={"api_endpoint": "https://api.arouter.ai"},
    )
    ```
  </Tab>

  <Tab title="Wallet JWT (SIWx)">
    **暗号ウォレットを持つ AI エージェント**（EVM または Solana）で使用されます。ウォレットは `SIGN-IN-WITH-X` で認証し、その後ウォレット JWT を Bearer token として使用します。

    ```bash theme={null}
    Authorization: Bearer eyJhbGciOiJIUzI1NiIs...
    ```

    ウォレット JWT は SIWx を介して `POST /v1/x402/auth` から取得するか、最初の x402 支払いレスポンスから取得します。

    完全なウォレットフローについては [x402 支払いガイド](/jp/guides/x402-payments) をご覧ください。
  </Tab>
</Tabs>

<Info>
  最初の 3 つの方式は同じ ARouter API key を使用します。ゲートウェイはどの方式が使用されているかを自動的に検出します。ウォレットユーザーは別のパスをたどります：SIWx/x402 がウォレット JWT を生成し、その後のリクエストは `Authorization: Bearer <jwt>` を使用します。
</Info>

## Key の種類

| Key の種類     | 形式             | 説明                                      |
| ----------- | -------------- | --------------------------------------- |
| **管理 Key**  | `lr_mgmt_xxxx` | 管理 API を通じて API key を作成・管理する。           |
| **API Key** | `lr_live_xxxx` | LLM リクエストを送信する。プロバイダー/モデルの制限と利用上限を設定可能。 |

管理 key で作成した API key は、テナントのスコープを超えることなく、権限を**制限する**ことのみできます。

詳細については [Key 管理ガイド](/jp/guides/key-management) をご覧ください。

## エラーレスポンス

認証に失敗すると、次のいずれかのレスポンスが返されます：

```json theme={null}
// key が欠落しているか、形式が正しくない場合
{
  "error": {
    "message": "missing or invalid Authorization header",
    "type": "authentication_error"
  }
}
```

```json theme={null}
// 無効な key の場合
{
  "error": {
    "message": "invalid api key",
    "type": "authentication_error"
  }
}
```

どちらも HTTP `401 Unauthorized` を返します。