> ## 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ゲートウェイ＆ルーターサービス

> Alter を OpenAI 互換の API エンドポイントとして使用して、92 以上の AI モデルにアクセスする

Alter は、10 を超えるプロバイダーの 92 を超える AI モデルにアクセスするための統合ルーターとして Alter を使用できるようにする OpenAI 互換の API エンドポイントを提供します。 Alter API は、サードパーティ アプリケーションのバックエンドとして、またはカスタム プロジェクトの直接 API サービスとして使用します。

<Warning>
  **想定される用途:** API Router は個人利用、軽量ユーティリティ、低ボリュームのプロジェクト向けです。高スループットの agentic システムやマルチユーザー向けサービスには**適していません**。
</Warning>

## 概要

Alter API ゲートウェイは、さまざまな AI プロバイダー間で複数の API キーと請求先アカウントを管理する必要をなくす集中型ルーターです。請求の詳細を多くのプロバイダーに分散させる代わりに、Alter を AI モデルにアクセスするための単一のエントリ ポイントとして使用できます。

### Alter ルーターとは何ですか?

Alter 自体は **ルーター サービス**、つまり以下へのアクセスを提供する統合 API ゲートウェイです。

* 10 個以上の AI モデル プロバイダー (OpenAI、Gemini、Claude、Mistral など)
* 92 以上の個別 AI モデル
* 認証と請求の簡素化
* コードを変更せずに簡単にモデルを切り替えることができます

## 主な特長

* **OpenAI 準拠のエンドポイント** チャット完了とモデル リストをサポート
* Alter アカウントによる **集中請求**
* **外部アプリケーションまたはカスタム コードからすべてのモデルにアクセス**
* **既存の OpenAI 互換ツールおよび SDK とのシームレスな統合**
* すべてのプロバイダーにわたる **柔軟なモデル選択**

## はじめる

### 1. APIキーの生成

1. Alter 設定を開きます (**⌘ 、** または \[設定] メニュー)
2. **ルーター** タブに移動します
3. 「Alter API キー」セクションで、「新しいキーを追加」をクリックして新しい API キーを生成します。
4. キーをコピーします (`sk-` で始まる)

**重要:** API キーは決して共有しないでください。パスワードのように扱います。

### 2. エンドポイントを取得する

Alter ルーター エンドポイントは次のとおりです。

```
https://alterhq.com/api
```

一部のツールでは、`/v1` を追加する必要がある場合があります。

```
https://alterhq.com/api/v1
```

### 3. 利用可能なモデルのリスト

利用可能なモデルを確認してください:

```bash theme={null}
curl https://alterhq.com/api/models \
  -H "Authorization: Bearer YOUR_API_KEY"
```

これにより、10 プロバイダーの 92 以上のすべてのモデルとその機能が返されます。

## モデルの命名規則

Alter API を使用する場合、モデル名は次の形式に従います。

```
<Provider>#<Model-name>
```

### 例:

* `OpenAI#gpt-5` - 最新の GPT-5
* `OpenAI#gpt-5-nano` - 軽量 GPT
* `Claude#claude-sonnet-4-6` - 最新の Claude
* `Gemini#gemini-2.5-pro` - 最新の Gemini
* `Mistral#mistral-small-latest` - ミストラル モデル
* `Alter#best` - Alter の最高のモデル

## 利用方法

### サードパーティ製アプリケーションの場合

SillyTavern、NovelCrafter などのツールのバックエンドとして Alter を使用します。

1. ベース URL を設定します: `https://alterhq.com/api` (または `/v1`)
2. API キーを入力してください
3. モデルを選択するときは `Provider#Model-name` 形式を使用してください

### カスタム開発向け

#### Python (OpenAI SDK を使用)

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

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://alterhq.com/api/v1"
)

response = client.chat.completions.create(
    model="OpenAI#gpt-5",
    messages=[
        {"role": "user", "content": "What is machine learning?"}
    ]
)

print(response.choices[0].message.content)
```

#### JavaScript (OpenAI SDK を使用)

```javascript theme={null}
import OpenAI from 'openai';

const openai = new OpenAI({
    apiKey: "YOUR_API_KEY",
    baseURL: "https://alterhq.com/api/v1",
    dangerouslyAllowBrowser: true
});

const completion = await openai.chat.completions.create({
    model: "OpenAI#gpt-5",
    messages: [
        {"role": "user", "content": "Hello!"}
    ]
});

console.log(completion.choices[0].message.content);
```

#### ラングチェーン (Python)

```python theme={null}
from langchain_openai import ChatOpenAI

chat = ChatOpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://alterhq.com/api/v1",
    model="OpenAI#gpt-5"
)

response = chat.invoke("What is AI?")
print(response.content)
```

#### Direct cURL

```bash theme={null}
curl https://alterhq.com/api/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "OpenAI#gpt-5",
    "messages": [
      {"role": "user", "content": "What is machine learning?"}
    ]
  }'
```

## モデル選択ガイド

### スピードのために

* `Alter#light` - 軽量モデル
* `OpenAI#gpt-5-nano` - 軽量 GPT
* `Gemini#gemini-2.5-flash-lite` - 高速 Gemini

### 品質のために

* `Alter#best` - 入手可能な最良のもの
* `OpenAI#gpt-5` - 最も有能な GPT
* `Gemini#gemini-2.5-pro` - 強力な Gemini
* `Claude#claude-sonnet-4-6` - 最新の Claude

### 視覚・画像用

* `OpenAI#gpt-5` - 高度なマルチモーダル
* `Gemini#gemini-2.5-pro` - 強いビジョン
* `Mistral#pixtral-large-latest` - ビジョン対応

### コーディング用

* `OpenAI#gpt-5` - 優れたコード
* `Mistral#codestral-2501` - コードスペシャリスト
* `Claude#claude-sonnet-4-6` - 強力なコーディング

### コストについて

* `Alter#fair` - コスト効率が高い
* `Alter#light` - 最安
* `OpenAI#gpt-5-nano` - 予算 GPT

### ウェブ検索用

* `Perplexity#sonar` - Web 対応
* `Perplexity#sonar-pro` - 高度な検索

## サポートされているパラメータ

標準の OpenAI API パラメータは Alter で動作します。

* `model` - モデル ID (必須)
* `messages` - チャット メッセージ (必須)
* `temperature` - 0.0-2.0 (デフォルト: 1.0)
* `max_tokens` - 最大応答長
* `top_p` - 核のサンプリング
* `frequency_penalty` - 繰り返しにペナルティを与える
* `presence_penalty` - 新しいトピックを奨励します

## 一般的な使用例

### サードパーティアプリの統合

* **[シリータバーン](https://sillytavern.app/)** - ロールプレイング チャット
* **[ノベルクラフター](https://www.novelcrafter.com/)** - クリエイティブ ライティング
* その他の OpenAI 互換ツール

### カスタム アプリケーション バックエンド

* AIを必要とする社内ツール
* カスタマーサポートの自動化
* コンテンツ生成システム
* データ分析のワークフロー

### モデルの比較と A/B テスト

```python theme={null}
for model_id in ["OpenAI#gpt-5", "Claude#claude-sonnet-4-6", "Gemini#gemini-2.5-pro"]:
    # Run same prompt on different models
    # Compare outputs
```

### コストの最適化

大量のタスクには安価なモデルを使用し、複雑なクエリには強力なモデルを使用します。

## 構成

### APIキー管理

* **\[設定] > \[ルーター]** を通じて API キーを生成および管理します
* API キーを安全に保管し、決して公開しないでください
* セキュリティのためにキーを定期的にローテーションする
* 異なる環境 (dev/prod) ごとに異なるキーを使用する

### 使用制限

API ゲートウェイにはフェアユースの制限があります。

* **1 日の制限**: フェアユースの下では 1 日あたり 200 リクエスト
* **スロットリング**: 1 日の制限を超えると、リクエストは 10 分ごとに 1 件にスロットルされます。
* **予算の追加**: フェアユースの制限を超えた一貫したアクセスのために予算を「追加」します

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

### リストにないモデル

アプリケーションに利用可能なモデルがリストされていない場合:

* `Provider#Model-name` 形式を使用してモデルを手動で指定します
* API キーが正しいことを確認してください
* アプリケーションがモデル リスト エンドポイントをサポートしていることを確認する

### 認証エラー

* API キーが正しく入力されていることを確認してください
* 正しいエンドポイントを使用していることを確認してください: `https://alterhq.com/api` または `https://alterhq.com/api/v1`
* Alter アカウントがアクティブであり、良好な状態であることを確認してください

### 接続の問題

* アプリケーションが OpenAI 互換のエンドポイントをサポートしていることを確認します
* 最新バージョンの Alter を使用していることを確認してください
* `alterhq.com` へのネットワーク接続を確認してください

### 高遅延

* より高速なモデル (`OpenAI#gpt-5-nano` など) を試してください。
* ネットワーク接続を確認してください
* 長い応答にはストリーミングを使用する

## ベストプラクティス

1. **API キーを保護します** - 環境変数を使用し、決してハードコードしないでください
2. **使用状況を監視** - API 呼び出しを追跡し、アラートを設定します
3. **適切なモデルを選択します** - モデルの機能をタスクの複雑さに合わせます
4. **エラーを適切に処理します** - バックオフを使用した再試行ロジックを実装します。
5. **コストの最適化** - 日常的なタスクにはより高速/安価なモデルを使用します

## 関連ドキュメント

* [モデルの選択](/how-to/choose-generative-model)
* [設定 - ルーター構成](/how-to/settings-guide#router-settings)
* [設定 - APIキー](/how-to/settings-guide#api-keys-settings)