Para agentes de IA: guía paso a paso de configuración — /docs/agents.md, índice de documentación — /llms.txt.

Conecta los modelos de Gonka a tu herramienta

API compatible con OpenAI y Anthropic. Elige tu herramienta y obtén el comando de instalación, el prompt para el agente y la verificación.

Datos rápidos#

  • URL base para clientes de OpenAI API: https://gate.joingonka.ai/v1
  • URL base para clientes de Anthropic API, sin /v1: https://gate.joingonka.ai
  • La clave se envía en el encabezado Authorization: Bearer jg-… o x-api-key: jg-…
  • Lista de modelos disponibles: GET https://gate.joingonka.ai/v1/models
  • Modelo recomendado: MiniMaxAI/MiniMax-M2.7

Conectar una herramienta#

Elige tu herramienta: abajo tienes los tres pasos específicos para ella. El instalador configura con un solo comando las herramientas de la tabla inferior (25), el resto se conectan siguiendo la guía.

Claude Code

  1. Clave

    Regístrate en gate.joingonka.ai y crea una clave en tu panel de usuario. Justo después del registro recibirás 3M tokens gratis en tu cuenta.

    Obtener clave API
  2. Conexión

    El instalador configura Claude Code por sí solo: pedirá la clave con entrada oculta, escribirá la configuración y comprobará la conexión con una solicitud al gateway.

    Bash
    npx -y @joingonka/setup --tool claude-code --model MiniMaxAI/MiniMax-M2.7

    O delega la configuración a un agente de IA: envíale este prompt:

    Prompt para el agente
    Conecta Claude Code a JoinGonka Gateway —la API compatible con OpenAI y Anthropic de la red Gonka— siguiendo las instrucciones de https://gate.joingonka.ai/docs/agents.md. La clave te la daré yo: no la guardes en archivos del repositorio ni modifiques variables de entorno globales. Al final, comprueba la conexión con una solicitud corta e informa del resultado.

    Guía paso a paso: Claude Code.

  3. Verificación

    Saldo de la cuenta: esta solicitud no consume tokens:

    cURL
    curl -s https://gate.joingonka.ai/api/balance \
      -H "Authorization: Bearer $JOINGONKA_API_KEY"

    Solicitud corta al modelo: una respuesta con código 200 significa que todo está configurado:

    cURL
    curl -s https://gate.joingonka.ai/v1/chat/completions \
      -H "Authorization: Bearer $JOINGONKA_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{"model": "MiniMaxAI/MiniMax-M2.7", "messages": [{"role": "user", "content": "Say OK"}], "max_tokens": 32}'

Todas las herramientas#

HerramientaTipoInstalador
CursorIDE--tool cursor
Claude CodeAgente CLI--tool claude-code
OpenClawAgente CLI--tool openclaw
OpenCodeAgente CLI--tool opencode
ContinueIDE--tool continue
ClineIDE--tool cline
AiderAgente CLI--tool aider
LangChainFramework—
n8nFramework—
Open WebUIChat—
LibreChatChat—
HermesAgente CLI--tool hermes
Kilo CodeIDE--tool kilo
Roo CodeIDE--tool roo
LlamaIndexFramework—
PydanticAIFramework—
Vercel AI SDKFramework—
TanStack AIFramework—
ZCodeAgente CLI--tool zcode
JetBrainsIDE--tool jetbrains
Copilot BYOKIDE--tool copilot-byok
ZedIDE--tool zed
PiAgente CLI--tool pi
Codex CLIAgente CLI--tool codex
DeepSeek HarnessAgente CLI—
MiniMax CodeAgente CLI--tool minimax-code
WarpAgente CLI—
TraeIDE—
Cherry StudioChat—
omp (Oh My Pi)Agente CLI--tool omp
OpenHandsAgente CLI—
Qwen CodeAgente CLI--tool qwen-code
GooseAgente CLI--tool goose
CrushAgente CLI--tool crush
Zoo CodeIDE--tool zoo
Kimi CodeAgente CLI--tool kimi-code
Factory DroidAgente CLI--tool droid
MiMo CodeAgente CLI--tool mimo-code

Ejemplos de código#

La misma solicitud a través del SDK de OpenAI, cURL y el SDK de Anthropic. La clave se toma de la variable de entorno JOINGONKA_API_KEY.

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://gate.joingonka.ai/v1",
    api_key=os.environ["JOINGONKA_API_KEY"],
)

response = client.chat.completions.create(
    model="MiniMaxAI/MiniMax-M2.7",
    messages=[{"role": "user", "content": "What is Gonka?"}],
)
print(response.choices[0].message.content)

Secciones de la documentación#

  • API — Referencia de la API compatible con OpenAI y Anthropic para los modelos de la red Gonka: claves, parámetros, streaming, herramientas, plugins. Tokens gratis al registrarte.
  • Modelos — Los modelos de la red Gonka en una sola API: id para el campo model, contexto, límite de respuesta, precios y estado. Los mismos modelos abiertos a una fracción del precio.
  • Errores y límites — Códigos de error de la pasarela, límites de peticiones y tiempos de espera: qué significa cada respuesta y cuándo reintentar la petición.
  • Precios y cuenta — Modelos de la red Gonka con precio por token: tokens gratis para empezar, recarga con GNK, USDT o tarjeta, todas las comisiones a la vista y una API de cuenta para controlar tu gasto.
  • Para agentes — Pásale el enlace a tu agente de IA y conectará Claude Code, Cursor o Codex a los modelos de la red Gonka por su cuenta: prompt listo, guía y skill.