Switch to HopBase

Moving an existing app to HopBase means changing three values: the Base URL, the key, and sometimes the model string. Request bodies, streaming code, and error handling stay the same.

What changes

Which protocol each model family uses is listed in Base URLs and protocols.

OpenAI SDK

Set the Base URL and swap the key. OpenAI model IDs such as gpt-5.5 stay the same as long as your key's GET /v1/models lists them.

 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"}],
 )

Without touching code, both SDKs also read OPENAI_BASE_URL and OPENAI_API_KEY from the environment: set them to https://api.hop-base.com/v1 and your HopBase key. More examples are in OpenAI SDK.

Anthropic SDK

Claude keeps the Anthropic Messages API. Set the Base URL without /v1 and use a key from the Claude Max (Official, Full Quota) group. Keys from Claude Max (ccmax) work only in the Claude Code client; SDK calls with them fail.

 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"}],
 )

The environment-variable route works here too: ANTHROPIC_BASE_URL=https://api.hop-base.com. See Anthropic SDK.

OpenRouter

Change the Base URL and key, drop the vendor prefix from the model string, and remove the OpenRouter attribution headers — HopBase does not need them.

 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"}],
 )

If you reached Claude through OpenRouter's OpenAI-compatible endpoint, that path does not exist for Claude on HopBase: move those calls to the Anthropic SDK with a Claude-group key, as in the section above. Other families (Gemini, GLM, Qwen, DeepSeek, Kimi, Grok) stay on the OpenAI SDK, each with a key from its own group.

What is not supported

The full list of endpoints is in Base URLs and protocols.

Check the switch