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

# API Router 運用とトラブルシューティング

> Alter API Router のモデル選択、制限、信頼性、よくある解決策

## モデル選択クイックガイド

**速度**

* `Alter#light`
* `OpenAI#gpt-5-nano`
* `Gemini#gemini-2.5-flash-lite`

**品質**

* `Alter#best`
* `OpenAI#gpt-5`
* `Gemini#gemini-2.5-pro`
* `Claude#claude-sonnet-4-6`

**釣り**

* `OpenAI#gpt-5`
* `Mistral#codestral-2501`
* `Claude#claude-sonnet-4-6`

**ウェブ検索**

* `Perplexity#sonar`
* `Perplexity#sonar-pro`

## 利用制限

フェアユースの範囲では:

* 1日上限：`200`リクエスト/日
* 超過後: `10分あたり1リクエスト` に滞る
* 継続的に高い利用量が必要な場合: 予算をトップアップ

<Note>
  API Router は個人利用と低ボリュームのワークロード向けです。ユーザー製品や高ループスットのシステムには、プロバイダーの専用インフラを利用してください。
</Note>

## よくある問題

### モデルが表示されない

* モデルを `Provider#Model-name` 形式で手動指定する
* APIキーが有効か確認する
* クライアントが一覧モデルエンドポイントをサポートしているか確認する

### 認証エラー

* `Authorization: Bearer YOUR_API_KEY`を確認する
* エンドポイントが `https://alterhq.com/api` または `/api/v1` であることを確認する
* アカウントが有効であることを確認する

### 接続問題

* OpenAI互換クライアントを使用する
* `alterhq.com` へのネットワーク接続を確認する

### ハイレイテンシ

* 軽量モデルを挑戦（`OpenAI#gpt-5-nano`、`Alter#light`）
* 長文出力にはストリーミングを使う

## ベストプラクティス

1. APIキーは環境変数に保存する（ハードコードしない）
2. リクエスト量とエラー率を監視する
   3.タスクの複雑さに合わせてモデル能力を選ぶ
   4.バックオフ付きのリトライを実現する
3. ルーチン作業は低コストモデルを使う

## 関連

* [APIゲートウェイ＆ルーターサービス](/ja/api-router/api-gateway)
* [開発向けAPIルーター](/ja/api-router/development)
* [API Gatewayがモデルを表示しない](/ja/common-issues/models-not-listed-in-api-gateway)