Skip to content
NUEVONano Banana 2.1 ya está disponible: el nuevo modelo de imagen de Google, desde $0.0336 por imagen, 4K nativo y aproximadamente la mitad de precio que la generación anteriorVer modelo
HopBase
← Volver al blog

API de IA con una sola clave: Claude, GPT, DeepSeek y video

La respuesta corta: con HopBase un equipo en México o LatAm puede llamar a Claude, GPT, Gemini, Grok, DeepSeek, Qwen, GLM, Kimi y Doubao, además de modelos de video como Kling 4.0, Seedance y Hailuo, con una sola API key. Los modelos de chat usan el endpoint compatible con OpenAI https://api.hop-base.com/v1, así que el SDK oficial de OpenAI funciona cambiando solo base_url y la clave; Claude también acepta el protocolo nativo de Anthropic en https://api.hop-base.com, que es el que usa Claude Code. Cada clave puede incluir de 1 a 10 grupos de modelos y GET /v1/models te dice exactamente qué IDs puedes usar. Se paga por uso en dólares (USD), sin suscripción, con Visa / Mastercard, Apple Pay, Google Pay, Alipay o WeChat Pay, y cualquier comisión se muestra antes de pagar. Las solicitudes que fallan antes de generar salida no se cobran, y cada tarea de video devuelve en usage.cost_usd lo que realmente se descontó de tu saldo.

El problema que resuelve

Si tu producto combina un modelo de razonamiento para el backend, un modelo barato para clasificar tickets y un modelo de video para generar anuncios, terminas con tres cuentas, tres métodos de pago y tres formatos de API. En México y el resto de LatAm se suma un problema práctico: las tarjetas a veces se rechazan en compras internacionales y cada proveedor tiene reglas de pago distintas.

Un gateway con una sola clave reduce eso a una cuenta, un saldo en USD y un SDK. La pregunta útil no es "¿cuál es la alternativa a OpenRouter?", sino "¿qué necesita mi equipo de un gateway?". Al final de esta guía hay una lista neutral para decidir.

Qué modelos puedes llamar con una clave

Familia Ejemplos de ID Protocolo
Anthropic Claude claude-sonnet-5-5, claude-opus-5-5, claude-haiku-5-5 Anthropic Messages (/v1/messages)
OpenAI GPT gpt-6-sol, gpt-6-luna, gpt-5.6-sol Chat Completions y Responses
Google Gemini gemini-3.8-flash, gemini-4-argon Chat Completions, Responses y Anthropic Messages
xAI Grok grok-4.7 Chat Completions y Responses
DeepSeek deepseek-v4.1-flash-1017, deepseek-v4-pro-202606 Chat Completions, Responses y Anthropic Messages
Qwen, GLM, Kimi, Doubao Seed qwen3.8-max, glm-5.3, kimi-k3, doubao-seed-2-1-pro-260915 Chat Completions (y más, según el modelo)
Video kling-v4, dreamina-seedance-2-5-260628, MiniMax-H3 API de tareas asíncronas

La disponibilidad depende de los grupos que incluya tu clave. Antes de usar un ID, llama a GET /v1/models y usa solo lo que devuelva; un ID fuera de tus grupos responde 404 model_not_found.

Precios de lista oficiales (USD por millón de tokens)

Modelo Entrada Salida Caché (lectura)
claude-sonnet-5-5 $2 $10 $0.10
claude-haiku-5-5 (hasta 100K de prompt) $0.10 $0.50 $0.01
gpt-6-sol $2 $10 $0.20
gpt-6-luna $0.10 $0.50 $0.01
gemini-3.8-flash $0.75 $3.75 $0.075
grok-4.7 $2 $6 $0.50
kimi-k3 $3 $15 $0.30

Son los precios de lista de cada fabricante (instantánea del 2026-10-29). DeepSeek, Qwen, GLM y Doubao tienen su precio oficial en su propia moneda; consulta la página de precios, donde se indica cómo se cobra desde tu saldo en USD. Tu tarifa exacta aparece en la consola al iniciar sesión.

En video, kling-v4 (Kling 4.0) tiene un precio de lista de $0.1471 por segundo a 720p y $0.2206 a 1080p: un clip de 10 segundos a 720p cuesta 10 × $0.1471 ≈ $1.47. Parámetros, código y errores en nuestra guía de la API de Kling 4.0.

Código: el SDK de OpenAI con varios modelos

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.hop-base.com/v1",
    api_key=os.environ["HOPBASE_API_KEY"],  # nunca pongas la clave en el código
)

# 1. Qué modelos tiene esta clave
print([m.id for m in client.models.list().data])

# 2. Mismo código, distintos modelos
for model in ["gpt-6-luna", "gemini-3.8-flash", "deepseek-v4.1-flash-1017"]:
    r = client.chat.completions.create(
        model=model,
        messages=[{"role": "user", "content": "Resume en una línea: ¿qué es un CFDI?"}],
    )
    print(model, "→", r.choices[0].message.content)

Para Claude, usa el SDK de Anthropic con la base sin /v1:

import os
import anthropic

client = anthropic.Anthropic(
    base_url="https://api.hop-base.com",
    api_key=os.environ["HOPBASE_API_KEY"],
)
msg = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=256,
    messages=[{"role": "user", "content": "Escribe un saludo para clientes de Monterrey."}],
)
print(msg.content[0].text)

Claude Code con la misma cuenta

La forma más sencilla es la opción Configuración con un clic junto a tu clave en la consola: genera un comando para macOS / Linux o Windows PowerShell que instala Claude Code si hace falta, respalda tu configuración y verifica la conexión. Si prefieres hacerlo a mano:

export ANTHROPIC_BASE_URL="https://api.hop-base.com"
export ANTHROPIC_AUTH_TOKEN="tu-clave-con-grupo-claude"
claude

La clave debe incluir un grupo de Claude. Guía completa en español: Claude Code.

Pagar desde México: lo que necesitas saber

  • Moneda: el saldo y los cobros están en USD. No hay suscripción; pagas por uso.
  • Métodos: Visa / Mastercard, Apple Pay, Google Pay, Alipay, AlipayHK y WeChat Pay. Antes de pagar, la página de recarga muestra el monto a pagar, la comisión si la hay y el monto que se acreditará.
  • Si tu tarjeta se rechaza: muchos bancos bloquean por defecto las compras internacionales en línea; habilítalas con tu banco o usa otro de los métodos admitidos. Para transferencia bancaria empresarial, contáctanos.
  • Facturación: para facturas o datos fiscales de tu empresa, contacta a un asesor desde la página de contacto.

Controlar el gasto por equipo o por cliente

  • Crea una clave por proyecto o por cliente, cada una con su propio límite de gasto y de concurrencia. Al llegar al límite de gasto la API responde 402 insufficient_quota; al llegar al de concurrencia, 429.
  • La página Usage exporta CSV detallado (hasta 50,000 filas y 400 días por archivo) para conciliar línea por línea.
  • Las solicitudes rechazadas o fallidas antes de producir salida no se cobran; si una respuesta se corta a la mitad, solo se cobra lo ya generado.
  • Puedes consultar saldo y uso desde tu agente con el servidor MCP de solo lectura https://api.hop-base.com/mcp (get_balance, get_usage).

Cómo elegir un gateway (alternativa a OpenRouter o a cualquier otro)

Una lista neutral para comparar opciones, incluida la nuestra:

  1. Cobertura real: ¿están los modelos que usas hoy y los de video o voz que vas a necesitar? Revisa la lista de IDs, no el logo en la portada.
  2. Protocolos nativos: ¿Claude funciona con el protocolo de Anthropic (necesario para Claude Code) y GPT con Responses (necesario para Codex)?
  3. Pago: ¿acepta los métodos que tu equipo sí puede usar y muestra las comisiones antes de pagar?
  4. Costo verificable: ¿puedes leer el costo real de cada solicitud o tarea y exportarlo?
  5. Verificación del modelo: ¿el proveedor publica las características de servicio de cada grupo y acepta pruebas reproducibles? Nosotros publicamos un método en inglés: cómo verificar que tu proveedor no cambia de modelo.
  6. Datos y cumplimiento: si tu caso requiere evaluar protección de datos (LFPDPPP en México o RGPD en España), contacta a un asesor antes de enviar datos personales.

Preguntas frecuentes

¿Puedo usar el SDK oficial de OpenAI?

Sí. Cambia base_url a https://api.hop-base.com/v1 y usa tu clave de HopBase. Para Claude con el SDK de Anthropic, la base es https://api.hop-base.com sin /v1.

¿Puedo pagar en pesos mexicanos?

El saldo y los cobros están en USD. El método y la comisión de cada recarga se muestran en la página de recarga antes de pagar.

¿Emiten factura (CFDI)?

Para facturación y datos fiscales, contacta a un asesor desde la página de contacto; te indicará las opciones disponibles para tu empresa.

¿Me cobran si una solicitud falla?

No. Las solicitudes rechazadas o fallidas antes de producir salida no se cobran, y las tareas de video fallidas tampoco. Si una respuesta se interrumpe después de generar salida, solo se cobra lo generado.

¿Una clave sirve para chat y video a la vez?

Sí. Una clave puede incluir de 1 a 10 grupos de distintas plataformas, por ejemplo Claude, GPT y Kling. Cada solicitud la atiende y la cobra el grupo que cubre ese modelo.

¿Cuánto dura el enlace de un video generado?

24 horas desde que termina la tarea. Después responde 410, así que descarga el archivo a tu almacenamiento en cuanto esté listo.