メインコンテンツへ移動
AIチュートリアル

RouterHubで最先端・無検閲AIモデルにアクセスする方法

RouterHubの設定方法、最新モデルの選び方、OpenAI SDK、Anthropic SDK、またはcURLを使ったリクエスト送信方法を解説します。互換ツール、料金、モデル評価、プロンプトキャッシュ、プロジェクト分離、責任ある導入についても説明します。

約13分で読了
RouterHubで最先端・無検閲AIモデルにアクセスする方法

RouterHubの機能

RouterHubは、1つのアカウント、残高、APIキーで、Claude、GPT、Gemini、Grok、DeepSeek、GLM、Qwenの各モデルファミリーにアクセスできるAI APIゲートウェイです。OpenAI互換およびAnthropic互換のインターフェースに対応しているため、APIキー、ベースURL、モデルIDを変更するだけで、多くの既存アプリケーションをプロバイダー間で切り替えられます。

カタログには、標準的な最先端モデルに加え、提供されている場合は一部の無制限およびアブリテレート済みのバリアントも含まれます。無制限モデルとは、標準リリースよりも少ない要求を拒否するよう設計されたバリアントです。モデルはエンジンであり、APIはアプリケーションがそのモデルに接続するための接続手段です。

重要: 拒否動作が少ないことは、モデルがすべての要求に回答することを保証するものではありません。動作はモデル、バージョン、プロンプト、プロバイダーのポリシーによって異なります。合法的かつ倫理的な利用、適切なガードレール、人による確認については、利用者が責任を負います。

主な機能

  • 複数のモデルファミリーで1つのアカウント: ファミリーごとに個別の統合を維持することなく、Claude、GPT、Gemini、Grok、DeepSeek、GLM、Qwenを利用できます。
  • OpenAI互換: OpenAI SDKや、カスタムbase_urlに対応したアプリケーションを接続できます。
  • Anthropic互換: Anthropic SDKや、Claude CodeなどのAnthropic形式のクライアントを利用できます。
  • 一部の無制限オプション: 提供されている場合、標準モデルと併せて無制限およびアブリテレート済みのバリアントを評価できます。
  • 従量課金: 月額サブスクリプションや座席料金なしで、トークン単位で支払えます。
  • プロンプトキャッシュ: 繰り返し使用するプロンプトの先頭部分には、より低いキャッシュ入力料金が適用される場合があります。
  • プロジェクト分離: 個別のAPIキーを作成して、プロジェクトを分け、使用量を監視できます。
  • 柔軟なチャージ: カードまたは暗号資産で前払いクレジットを追加できます。

モデルファミリーの選択

選択は、ファミリー名だけでなく、ワークロードに応じて決める必要があります。RouterHubのダッシュボードには、現在利用できるモデルID、コンテキスト上限、料金、提供状況が表示されます。

  • Claude: 長文の推論、文章作成、コーディングエージェント。
  • GPT: 汎用アシスタント、ツール利用、構造化出力。
  • Gemini: マルチモーダルワークフロー、調査、長いコンテキストを扱うタスク。
  • Grok: アイデア創出やリアルタイム型の回答。
  • DeepSeek: コーディング、推論、コスト効率の高いエージェント。
  • GLM: エージェントワークフロー、コーディング、バイリンガルタスク。
  • Qwen: 長文書の読解やエージェントワークフロー。

プロバイダーが新しいバージョンを公開すると、モデルの提供状況は変わります。古いIDがまだ有効だと仮定せず、必ずRouterHubダッシュボードから現在のモデルIDをコピーしてください。

インストールとセットアップ

1. アカウントとAPIキーを作成する

RouterHubのオンボーディングページから登録します。生成されたAPIキーはsk-で始まります。ダッシュボードの概要には、選択したインターフェースに必要な正確なベースURLも表示されます。

2. 認証情報を環境変数として保存する

認証情報をソースファイルに直接記述することは避けてください。シェルでキーとOpenAI互換のベースURLをエクスポートします。

export ROUTERHUB_API_KEY="sk-..."
export ROUTERHUB_BASE_URL="https://.../v1"

実際のURLはダッシュボードからコピーしてください。Anthropicクライアントでは、OpenAI互換URLと同一だと仮定せず、ダッシュボードに表示されるAnthropic互換のベースURLを使用してください。

3. アプリケーションに必要なSDKをインストールする

OpenAI互換のPython例では、OpenAI SDKをインストールします。

python -m pip install openai

Anthropic互換の例では、Anthropic SDKをインストールします。

python -m pip install anthropic

必要なのはプロジェクトで使用するSDKだけです。直接cURLリクエストを送る場合、どちらのPythonパッケージも必要ありません。

OpenAI SDKの基本的な使い方

OpenAIクライアントを作成し、RouterHubの認証情報を指定して、MODEL_IDをダッシュボードにある現在のIDに置き換えます。

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["ROUTERHUB_API_KEY"],
    base_url=os.environ["ROUTERHUB_BASE_URL"],
)

response = client.chat.completions.create(
    model="MODEL_ID",
    messages=[
        {
            "role": "system",
            "content": "正確で役立つアシスタントとして振る舞ってください。"
        },
        {
            "role": "user",
            "content": "モデルルーティングのトレードオフを2つの段落で説明してください。"
        },
    ],
)

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

modelフィールドは、リクエストを処理する利用可能なモデルを指定します。システムメッセージはアシスタントの一般的な動作を定義し、ユーザーメッセージにはタスクが含まれます。

Anthropic SDKの基本的な使い方

Anthropic SDKを使用する場合は、ダッシュボードに表示されるAnthropic互換エンドポイントを指定します。

import os
from anthropic import Anthropic

client = Anthropic(
    api_key=os.environ["ROUTERHUB_API_KEY"],
    base_url=os.environ["ROUTERHUB_BASE_URL"],
)

message = client.messages.create(
    model="MODEL_ID",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": "開発者ツールの簡潔なリリースノートを書いてください。"
        }
    ],
)

print(message.content[0].text)

AnthropicリクエストではMessages APIの形式を使用し、max_tokensを設定して生成されるレスポンスを制限します。この例を実行する前に、環境変数にAnthropic互換URLが含まれていることを確認してください。

cURLでAPIをテストする

大規模なアプリケーションにSDKを追加する前に、直接HTTPリクエストを実行すると、認証情報とモデルの利用可能性を確認できます。

curl "$ROUTERHUB_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $ROUTERHUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "messages": [
      {
        "role": "user",
        "content": "Hello from the RouterHub quickstart."
      }
    ]
  }'

リクエストが失敗する場合は、APIキー、ベースURL、エンドポイントパス、現在のモデルIDを確認してください。上流モデルの更新後に、利用可能なモデルや識別子が変わることがあります。

既存の開発者ツールに接続する

RouterHubは、OpenAI互換またはAnthropic互換のカスタムプロバイダーを設定できるクライアントで利用できます。

  • Claude Code: AnthropicのベースURL設定をRouterHubに指定します。
  • Cursor: カスタムOpenAI互換プロバイダーとしてRouterHubを追加します。
  • Codex CLI: OpenAI互換プロバイダーのプロファイルを設定します。
  • OpenCode: カスタムプロバイダーと有効なモデルIDを設定します。
  • LangChainとLlamaIndex: OpenAI互換アダプターを使用します。
  • その他の互換アプリケーション: ベースURLとAPIキーを置き換え、対応するモデルIDを選択します。

追加の環境変数やプロバイダー設定が必要な場合は、リポジトリのクライアント固有のドキュメントに従ってください。

高度なヒント

再現可能なテストセットでモデルを比較する

1つのプロンプトだけでモデルを評価しないでください。実際のタスクを反映した小規模なテストセットを作成し、複数のモデルファミリーに同じプロンプトを送信します。本番モデルを選ぶ前に、回答品質、拒否動作、レイテンシ、一貫性、トークンコストを比較してください。

正確なモデルバージョンを再テストする

動作はバージョンによって異なります。あるリリースで機能したプロンプトでも、上流で更新された後は結果が変わる可能性があります。各評価で使用したモデルIDを記録し、モデルやバージョンを変更するたびに重要なテストを繰り返してください。

APIキーを分ける

開発、テスト、本番、または個々のクライアントごとに異なるキーを作成します。これによりプロジェクトを分離でき、共有ダッシュボードから利用状況を監視しやすくなります。キーをリポジトリにコミットしたり、ブラウザーコードで公開したりしないでください。

キャッシュを考慮してプロンプトを設計する

プロンプトキャッシュにより、繰り返し使用する入力プレフィックスの課金コストを削減できます。アプリケーションに適した構成であれば、安定した指示や共有コンテキストをリクエストの先頭に置き、変化するユーザーコンテンツを後ろに配置します。

最新の料金と制限を確認する

RouterHubはトークン従量課金を採用しており、サブスクリプションは必要ありません。ただし、プロバイダーの料金、モデルの利用可能性、制限は変更される場合があります。本番コストを見積もる前や特定のモデルに依存する前に、ダッシュボードを確認してください。

アプリケーションレベルの安全対策を維持する

無検閲版やアブレーション版は拒否を減らしますが、検証が不要になるわけではありません。用途に適したガードレールを追加し、センシティブな出力を確認し、プロバイダーの規約に従い、適用される法律を遵守してください。自律エージェントや一般公開のアシスタントでは、特に重要です。

実用的なユースケース

  • AI安全性やレッドチーム研究のため、バージョン間でポリシーへの対応を比較する。
  • シーン途中での拒否を減らした創作ワークフローを構築し、別途編集レビューを行う。
  • 互換性のあるコーディングクライアントから、Claude、GPT、DeepSeek、GLMにコーディングタスクを振り分ける。
  • 統合を作り直すことなく、複数のモデルファミリーで多言語プロンプトをテストする。
  • 長文コンテキストの要約やドキュメント分析のワークフローを構築する。
  • キー、請求、利用状況を一元管理しながら、チャットボットやアシスタントのバックエンドを稼働させる。

まとめ

RouterHubは、1つのアカウントで複数の最先端モデルファミリーをテスト・利用するための互換ゲートウェイを提供します。まずキーを取得し、正しいベースURLと現在のモデルIDをコピーして、簡単なSDKまたはcURLリクエストを実行してください。本番導入の前に、モデルを体系的に比較し、プロジェクトごとにキーを分離し、最新の料金を確認するとともに、適切な安全管理と人間による監督を維持してください。