HopBase への移行

既存アプリを HopBase に移すには、Base URL、キー、場合によってはモデル名の 3 つを変えるだけです。リクエストボディ、ストリーミング処理、エラー処理のコードはそのまま使えます。

変更する項目

モデルファミリーごとのプロトコルは Base URL とプロトコルを参照してください。

OpenAI SDK

Base URL を設定し、キーを差し替えます。gpt-5.5 などの OpenAI モデル ID は、キーの GET /v1/models に含まれていればそのままで構いません。

 import os
 from openai import OpenAI

 client = OpenAI(
-    api_key=os.environ["OPENAI_API_KEY"],
+    base_url="https://api.hop-base.com/v1",
+    api_key=os.environ["HOPBASE_OPENAI_API_KEY"],
 )

 resp = client.chat.completions.create(
     model="gpt-5.5",
     messages=[{"role": "user", "content": "Hello"}],
 )

コードを変えたくない場合、どちらの SDK も環境変数 OPENAI_BASE_URL と OPENAI_API_KEY を読み込みます。それぞれ https://api.hop-base.com/v1 と HopBase のキーを設定してください。ほかの例は OpenAI SDK にあります。

Anthropic SDK

Claude は Anthropic Messages API のまま使います。Base URL は /v1 を付けず、キーは「Claude Max(公式フル枠)」グループのものを使ってください。「Claude Max（ccmax）」グループのキーは Claude Code クライアント専用で、SDK からの呼び出しは失敗します。

 import os
 from anthropic import Anthropic

 client = Anthropic(
-    api_key=os.environ["ANTHROPIC_API_KEY"],
+    base_url="https://api.hop-base.com",
+    api_key=os.environ["HOPBASE_CLAUDE_API_KEY"],
 )

 msg = client.messages.create(
     model="claude-sonnet-5",
     max_tokens=1024,
     messages=[{"role": "user", "content": "Hello"}],
 )

こちらも環境変数だけで切り替えられます:ANTHROPIC_BASE_URL=https://api.hop-base.com。詳細は Anthropic SDK を参照してください。

OpenRouter

Base URL とキーを変え、モデル名からベンダー接頭辞を外し、OpenRouter の帰属ヘッダーを削除します。HopBase では不要です。

 import os
 from openai import OpenAI

 client = OpenAI(
-    base_url="https://openrouter.ai/api/v1",
-    api_key=os.environ["OPENROUTER_API_KEY"],
-    default_headers={"HTTP-Referer": "https://your-app.example", "X-Title": "Your App"},
+    base_url="https://api.hop-base.com/v1",
+    api_key=os.environ["HOPBASE_OPENAI_API_KEY"],
 )

 resp = client.chat.completions.create(
-    model="openai/gpt-5.5",
+    model="gpt-5.5",
     messages=[{"role": "user", "content": "Hello"}],
 )

OpenRouter の OpenAI 互換エンドポイント経由で Claude を呼んでいた場合、HopBase には Claude 用のその経路はありません。前節のとおり、Claude グループのキーで Anthropic SDK に切り替えてください。その他のファミリー(Gemini、GLM、Qwen、DeepSeek、Kimi、Grok)は OpenAI SDK のまま、それぞれのグループのキーを使います。

非対応の機能

エンドポイントの一覧は Base URL とプロトコルにあります。

移行後の確認