Cambiar a HopBase

Pasar una aplicación existente a HopBase consiste en cambiar tres valores: la Base URL, la clave y, a veces, el nombre del modelo. Los cuerpos de las solicitudes, el código de streaming y el manejo de errores no cambian.

Qué cambia

El protocolo de cada familia de modelos está en Base URL y protocolos.

SDK de OpenAI

Configure la Base URL y cambie la clave. Los ID de modelo de OpenAI como gpt-5.5 se mantienen siempre que aparezcan en GET /v1/models para su clave.

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

Sin tocar el código: ambos SDK leen también OPENAI_BASE_URL y OPENAI_API_KEY del entorno; asígneles https://api.hop-base.com/v1 y su clave de HopBase. Hay más ejemplos en OpenAI SDK.

SDK de Anthropic

Claude mantiene la API Messages de Anthropic. Configure la Base URL sin /v1 y use una clave del grupo Claude Max (oficial, cuota completa). Las claves del grupo Claude Max (ccmax) solo funcionan en el cliente Claude Code; las llamadas desde el SDK fallan.

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

La vía de las variables de entorno también sirve aquí: ANTHROPIC_BASE_URL=https://api.hop-base.com. Consulte Anthropic SDK.

OpenRouter

Cambie la Base URL y la clave, quite el prefijo de proveedor del nombre del modelo y elimine los encabezados de atribución de OpenRouter: HopBase no los necesita.

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

Si llamaba a Claude a través del endpoint compatible con OpenAI de OpenRouter, esa ruta no existe para Claude en HopBase: pase esas llamadas al SDK de Anthropic con una clave de un grupo Claude, como en la sección anterior. Las demás familias (Gemini, GLM, Qwen, DeepSeek, Kimi, Grok) siguen con el SDK de OpenAI, cada una con una clave de su propio grupo.

Lo que no está disponible

La lista completa de endpoints está en Base URL y protocolos.

Comprobar el cambio