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-…ox-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
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 APIConexió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.
Bashnpx -y @joingonka/setup --tool claude-code --model MiniMaxAI/MiniMax-M2.7O delega la configuración a un agente de IA: envíale este prompt:
Prompt para el agenteConecta 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.
Verificación
Saldo de la cuenta: esta solicitud no consume tokens:
cURLcurl -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:
cURLcurl -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#
| Herramienta | Tipo | Instalador |
|---|---|---|
| Cursor | IDE | --tool cursor |
| Claude Code | Agente CLI | --tool claude-code |
| OpenClaw | Agente CLI | --tool openclaw |
| OpenCode | Agente CLI | --tool opencode |
| Continue | IDE | --tool continue |
| Cline | IDE | --tool cline |
| Aider | Agente CLI | --tool aider |
| LangChain | Framework | — |
| n8n | Framework | — |
| Open WebUI | Chat | — |
| LibreChat | Chat | — |
| Hermes | Agente CLI | --tool hermes |
| Kilo Code | IDE | --tool kilo |
| Roo Code | IDE | --tool roo |
| LlamaIndex | Framework | — |
| PydanticAI | Framework | — |
| Vercel AI SDK | Framework | — |
| TanStack AI | Framework | — |
| ZCode | Agente CLI | --tool zcode |
| JetBrains | IDE | --tool jetbrains |
| Copilot BYOK | IDE | --tool copilot-byok |
| Zed | IDE | --tool zed |
| Pi | Agente CLI | --tool pi |
| Codex CLI | Agente CLI | --tool codex |
| DeepSeek Harness | Agente CLI | — |
| MiniMax Code | Agente CLI | --tool minimax-code |
| Warp | Agente CLI | — |
| Trae | IDE | — |
| Cherry Studio | Chat | — |
| omp (Oh My Pi) | Agente CLI | --tool omp |
| OpenHands | Agente CLI | — |
| Qwen Code | Agente CLI | --tool qwen-code |
| Goose | Agente CLI | --tool goose |
| Crush | Agente CLI | --tool crush |
| Zoo Code | IDE | --tool zoo |
| Kimi Code | Agente CLI | --tool kimi-code |
| Factory Droid | Agente CLI | --tool droid |
| MiMo Code | Agente 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)import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://gate.joingonka.ai/v1",
apiKey: process.env.JOINGONKA_API_KEY,
});
const response = await client.chat.completions.create({
model: "MiniMaxAI/MiniMax-M2.7",
messages: [{ role: "user", content: "What is Gonka?" }],
});
console.log(response.choices[0].message.content);curl 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": "What is Gonka?"}]
}'import os
import anthropic
client = anthropic.Anthropic(
base_url="https://gate.joingonka.ai",
api_key=os.environ["JOINGONKA_API_KEY"],
)
message = client.messages.create(
model="MiniMaxAI/MiniMax-M2.7",
max_tokens=1024,
messages=[{"role": "user", "content": "What is Gonka?"}],
)
print(message.content[0].text)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.