Inicio rápido
Regístrese, cree una clave API, elija la dirección del protocolo correcto y envíe su primera solicitud.
| Caso de uso | Dirección |
|---|---|
| Protocolo Anthropic Claude Code y modelos Claude | https://api.hop-base.com |
| Protocolo OpenAI chat de Codex, GPT, Gemini, GLM, Qwen, DeepSeek y Grok, y modelos de imagen | https://api.hop-base.com/v1 |
| Clave API | sk-xxxxxx (creada en la consola) |
| Descubrir los modelos disponibles para la clave | GET https://api.hop-base.com/v1/models |
La Base URL de Anthropic no incluye /v1; los clientes de Anthropic añaden la ruta de la API por su cuenta. La Base URL de OpenAI debe incluir /v1.
Pasos de configuración
Tres pasos: regístrese, cree una clave y ponga la Base URL y la clave en su herramienta o código.
Regístrese o inicie sesión
Abra api.hop-base.com/login para registrarse o iniciar sesión. El registro está abierto.
Cree una clave API
En la barra lateral de la consola, abra Claves API, seleccione Crear clave y elija uno o varios grupos. Obtendrá una clave que empieza por sk-.
Los grupos deciden qué modelos puede llamar la clave. Cada grupo sirve una familia de modelos (como Claude, GPT o Gemini), y una clave puede incluir de 1 a 10 grupos de distintas familias, así que una sola clave puede cubrir Claude, GPT, video y voz. También puede editar una clave existente para añadir grupos. Los grupos cuyos modelos se solapan no pueden compartir clave (excepción: GPT oficial directo (Azure) puede combinarse con Codex Plus o con Codex Pro), y un grupo de suscripción debe ser el único grupo de su clave.
Consulte Cómo elegir el grupo más abajo para saber qué grupo sirve cada modelo.
Configure la Base URL
Configure como Base URL de su herramienta o código la dirección de su protocolo en la tabla anterior e introduzca la clave.
Envíe su primera solicitud
Mi clave API
Crear una clavePegue una clave para ver qué modelos puede usar y cuánto puede gastar. Los ejemplos de las páginas de inicio rápido y de los SDK pasarán a usar modelos de su clave. La clave se queda en este navegador y solo se envía a api.hop-base.com.
Primero obtenga la lista de modelos que puede llamar la clave actual:
curl https://api.hop-base.com/v1/models \
-H "Authorization: Bearer sk-your-key"Luego envíe una solicitud de chat mínima. Las pestañas curl, Python, Node.js, Go y Java llaman a gpt-5.6-sol con el protocolo OpenAI y necesitan una clave de un grupo Codex; la pestaña Claude llama a claude-sonnet-5 con el protocolo Anthropic y necesita una clave de un grupo Claude. Para otra familia de modelos, sustituya model por un ID que /v1/models devuelva para esa clave.
curl https://api.hop-base.com/v1/chat/completions \
-H "Authorization: Bearer sk-your-key" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.6-sol",
"messages": [{"role": "user", "content": "Responde solo: ok"}]
}'Una llamada correcta devuelve HTTP 200. El protocolo OpenAI coloca la respuesta en choices[0].message.content, el protocolo Anthropic en content[0].text, y ambos incluyen un objeto usage:
{
"object": "chat.completion",
"model": "gpt-5.6-sol",
"choices": [{
"index": 0,
"message": { "role": "assistant", "content": "ok" },
"finish_reason": "stop"
}],
"usage": { "prompt_tokens": 12, "completion_tokens": 2, "total_tokens": 14 }
}Un 401 significa que la clave es incorrecta. Un 404 que indica que el grupo no admite el modelo significa que ninguno de los grupos de la clave sirve ese modelo: use un ID de /v1/models o añada el grupo correspondiente a la clave.
Para que un agente de codificación realice los cambios en el proyecto, continúe con Integración con IA.
Saldo y facturación
- Prepago: recargue su cuenta en Recarga, en la barra lateral de la consola; cada llamada se descuenta del saldo según el uso real. Cuando el saldo se agota, las nuevas solicitudes devuelven
402. - Tarifas: el catálogo de modelos con sesión iniciada es la referencia; cada cargo aparece detallado en Consumo en la consola.
- Los fallos no se cobran: en principio, las solicitudes fallidas no se facturan; un stream que se corta a mitad se factura por la salida ya producida. Reglas completas: Concurrencia, tiempos de espera y facturación.
Cómo elegir el grupo
Elija los grupos según los modelos que quiera llamar. Una clave puede incluir de 1 a 10 grupos, y cada solicitud se factura con la tarifa del grupo que sirve su modelo. El diálogo de claves solo lista los grupos actualmente en venta y no permite combinar grupos cuyos modelos se solapan (salvo GPT oficial directo (Azure) con un grupo Codex; vea la nota tras la tabla de GPT); un grupo de suscripción debe ser el único grupo de su clave. Las tarifas dependen de su cuenta y son autoritativas en el catálogo de modelos con sesión iniciada; estas tablas solo indican qué grupo sirve qué modelos. Los nombres de grupo son los que muestra la consola en español.
Claude Code y la API de Claude
| Grupo en la consola | Modelos y notas |
|---|---|
| Claude Max (oficial, cuota completa) | Todos los modelos Claude; funciona con la API de Claude, los SDK y Claude Code |
| Claude Max (oficial, cuota completa) - Oferta limitada | Igual que el anterior |
| Claude Max (ccmax) | Todos los modelos Claude, solo en el cliente Claude Code; las llamadas directas por SDK o API fallan |
Chat y programación (protocolo OpenAI)
| Grupo en la consola | Modelos y notas |
|---|---|
| Codex Plus · Codex Pro | Chat GPT y Codex CLI (Chat Completions / Responses); sin GPT Image |
| GPT oficial directo (Azure) | gpt-5.4, gpt-5.5, gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna; funciona con Chat Completions, Responses y Anthropic Messages; sin modelos GPT-6, codex-* ni GPT Image |
| Gemini (todos los modelos, incl. imagen) | Chat Gemini e imágenes Banana con el protocolo OpenAI |
| Gemini oficial directo | Chat Gemini, imágenes Banana y video Omni; el mismo endpoint acepta también cuerpos de solicitud nativos de Gemini |
| GLM oficial directo | glm-5.3 y glm-5.3-flash |
| Kimi K3 Cloud | kimi-k3 |
| DeepSeek | DeepSeek V4.1 Flash, V4 Pro y V4 Flash |
| Serie Qwen 3.8/3.7 (oficial de Alibaba) | Los cinco modelos de chat de Qwen, algunos con entrada de imagen o video |
| Grok gama completa | Chat Grok y generación de imágenes Grok |
Combinar Azure y Codex: una clave puede incluir GPT oficial directo (Azure) junto con Codex Plus o con Codex Pro; no hace falta elegir el origen.
- Los modelos presentes en ambos grupos (
gpt-5.4,gpt-5.5,gpt-5.6-sol,gpt-5.6-terra,gpt-5.6-luna) usan primero el grupo Azure, sin importar el orden en que seleccionó los grupos. Si Azure falla antes de devolver ninguna salida, la solicitud cambia automáticamente al otro grupo. Si la respuesta ya empezó y se interrumpe, no se cambia. - Cada solicitud se factura según el grupo que realmente la atendió, y el registro de uso muestra ese grupo.
- Los modelos que están en un solo grupo se atienden con ese grupo como siempre; por ejemplo, los modelos GPT-6 solo están en los grupos Codex.
- El diálogo de creación de claves, la lista de claves y el diálogo de conexión marcan estos dos grupos como Principal y Respaldo, con una nota breve sobre la facturación.
Los demás grupos cuyos modelos se solapan, como Codex Plus y Codex Pro, siguen sin poder compartir clave.
Generación de imágenes
| Grupo en la consola | Modelos y notas |
|---|---|
| GPT Image (todos los modelos) | Todos los modelos gpt-image-*: el único grupo que sirve GPT Image |
| Generación de imágenes Seedream | Generación y edición con Seedream |
| Midjourney generación de imágenes | Generación de imágenes con Midjourney |
Las imágenes Gemini Banana están en los dos grupos Gemini de arriba, las imágenes Grok en Grok gama completa y las imágenes Kling en Kling oficial, más abajo.
Generación de video
| Grupo en la consola | Modelos y notas |
|---|---|
| Seedance China (Doubao) | Versión China de Seedance |
| Seedance internacional + Seedream | Versión internacional de Seedance, más imágenes Seedream |
| Grok Video | Generación de video con Grok: un grupo distinto de Grok gama completa |
| Kling oficial | Video, imagen, control de movimiento, avatar y sincronización labial de Kling |
| MiniMax H3 oficial | Video MiniMax H3 |
| MiniMax H3 Max oficial | Video MiniMax H3-Max: un grupo distinto de H3 |
| Wan 3.0 oficial | Video Wan 3.0 |
| HappyHorse 1.1 oficial | Video HappyHorse 1.1; comparte endpoint con Wan, pero es un grupo distinto |
Voz
| Grupo en la consola | Modelos y notas |
|---|---|
| MiniMax Speech oficial | Síntesis de voz y clonación de voz de MiniMax |
Los nombres de grupo y la oferta cambian a medida que se añaden o retiran modelos. Si un grupo de estas tablas no aparece en su consola, puede haber cambiado de nombre o haberse retirado: consulte el diálogo de creación de claves para ver la lista actual.
Próximos pasos
- OpenAI SDK, Anthropic SDK, curl: ejemplos completos de chat, streaming y llamadas a herramientas
- Modelos disponibles: IDs y capacidades de cada modelo
- Concurrencia, tiempos de espera y facturación: límites de concurrencia, tiempos de espera y reglas de facturación
- Códigos de error y reintentos: qué significa cada código de error y si conviene reintentar