> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mixroute.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# APIキーが無効になるのはなぜですか？

## よくあるエラー

以下のようなエラーメッセージが表示された場合、通常は**ベースURLの設定が誤っている**ことを示しています。

```json theme={null}
{
  "error": {
    "message": "Incorrect API key provided: sk-QqHvK***...",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}
```

<Warning>
  最もよくある間違い：MixRouteのAPIキーを使用しているのに、リクエストURLがOpenAIの`https://api.openai.com`を指したままになっている
</Warning>

## ベースURLとは？

ベースURLは、APIリクエストの送信先サーバーのアドレスです。プロバイダーによって、使用するベースURLは異なります。

### MixRouteのBase URLとAPIキーは一致している必要があります。

```python theme={null}
client = OpenAI(
    api_key="sk-mixroute-key",
    base_url="https://api.mixroute.ai/v1"
    # ✅ Using MixRoute Base URL
)
```

## 正しい設定

### 方法1：ベースURLを変更（推奨）

<Tabs>
  <Tab title="Python">
    ```python theme={null}
    from openai import OpenAI

    client = OpenAI(
        api_key="sk-your-mixroute-key",  # Key from Mixroute Api console
        base_url="https://api.mixroute.ai/v1"  # Use Mixroute Api URL
    )

    response = client.chat.completions.create(
        model="gpt-5.5",
        messages=[{"role": "user", "content": "Hello"}]
    )
    ```
  </Tab>

  <Tab title="Node.js">
    ```javascript theme={null}
    import OpenAI from 'openai';

    const client = new OpenAI({
      apiKey: 'sk-your-mixroute-key',
      baseURL: 'https://api.mixroute.ai/v1'
    });

    const response = await client.chat.completions.create({
      model: 'gpt-5.5',
      messages: [{ role: 'user', content: 'Hello' }]
    });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    curl https://api.mixroute.ai/v1/chat/completions \
      -H "Content-Type: application/json" \
      -H "Authorization: Bearer sk-your-mixroute-key" \
      -d '{
        "model": "gpt-5.5",
        "messages": [{"role": "user", "content": "Hello"}]
      }'
    ```
  </Tab>
</Tabs>

### 方法2: 環境変数

<Tabs>
  <Tab title="Linux/macOS">
    ```bash theme={null}
    export OPENAI_API_KEY="sk-your-mixroute-key"
    export OPENAI_BASE_URL="https://api.mixroute.ai/v1"
    ```
  </Tab>

  <Tab title="Windows PowerShell">
    ```powershell theme={null}
    $env:OPENAI_API_KEY="sk-your-mixroute-key"
    $env:OPENAI_BASE_URL="https://api.mixroute.ai/v1"
    ```
  </Tab>

  <Tab title="Windows CMD">
    ```cmd theme={null}
    set OPENAI_API_KEY=sk-your-mixroute-key
    set OPENAI_BASE_URL=https://api.mixroute.ai/v1
    ```
  </Tab>
</Tabs>

## 対応するURL形式

| 形式 | URL | ユースケース |
| - | - | - |
| /v1あり（推奨） | `https://api.mixroute.ai/v1` | ほとんどのライブラリ |
| 末尾のスラッシュあり | `https://api.mixroute.ai/v1/` | 一部のフレームワーク |
| 完全なパス | `https://api.mixroute.ai/v1/chat/completions` | cURL requests |

## 簡易テスト

cURLで設定を検証します。

```bash theme={null}
curl https://api.mixroute.ai/v1/models \
  -H "Authorization: Bearer sk-your-mixroute-key"
```

期待される結果: 利用可能なモデル一覧が返される

```json theme={null}
{
  "data": [
    {
      "id": "gpt-5.5",
      "object": "model"
    }
  ]
}
```

エラーが発生した場合は、次を確認してください。

1. APIキーが正しくコピーされていること（余分な空白がないこと）
2. ネットワーク接続が正常に動作している
3. アカウント残高が十分にある

## トラブルシューティング

<AccordionGroup>
  <Accordion title="ベースURLを変更してもエラーが発生する">
    考えられる原因:

    1. **入力ミス**：URLの綴りを確認
    2. **キャッシュの問題**：プログラムを再起動するか、キャッシュをクリアしてください
    3. **プロキシまたはミドルウェア**：ツールによってはリクエストがリダイレクトされる場合があります。
    4. **複数の設定**：設定ファイル、環境変数、コードの初期化処理を確認
  </Accordion>

  <Accordion title="キーが有効かどうか確認するには？">
    Mixroute APIコンソールで確認してください。

    1. [Mixroute APIコンソール](https://api.mixroute.ai/)にログイン
    2. 「トークン」ページに移動します
    3. キーのステータスが「有効」になっているか確認してください
    4. アカウント残高が十分にあることを確認してください
  </Accordion>

  <Accordion title="サードパーティ製ツールはどう設定しますか？">
    大半のツールには「カスタムAPI」のオプションがあります。

    * **API URL / ベースURL**: `https://api.mixroute.ai/v1`
    * **APIキー**: Mixroute APIコンソールからコピーしてください
    * **モデル名**：モデルリストを参照
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.