APIゲートウェイ＆ルーターサービス

​

概要

​

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

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

​

主な特長

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

​

はじめる

​

1. APIキーの生成

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

​

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

https://alterhq.com/api

https://alterhq.com/api/v1

​

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

curl https://alterhq.com/api/models \
  -H "Authorization: Bearer YOUR_API_KEY"

​

モデルの命名規則

<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 の最高のモデル

​

利用方法

​

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

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

​

カスタム開発向け

​

Python (OpenAI SDK を使用)

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 を使用)

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)

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

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 - 高度な検索

​

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

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

​

一般的な使用例

​

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

• シリータバーン - ロールプレイング チャット
• ノベルクラフター - クリエイティブ ライティング
• その他の OpenAI 互換ツール

​

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

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

​

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

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) ごとに異なるキーを使用する

​

使用制限

• 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. コストの最適化 - 日常的なタスクにはより高速/安価なモデルを使用します

​

関連ドキュメント

• モデルの選択
• 設定 - ルーター構成
• 設定 - APIキー