Per gli agenti AI: guida passo passo alla configurazione — /docs/agents.md, indice della documentazione — /llms.txt.
Collega i modelli Gonka al tuo strumento
API compatibile con OpenAI e Anthropic. Scegli il tuo strumento e ottieni il comando di installazione, il prompt per l'agente e la verifica.
Informazioni rapide#
- Base URL per i client OpenAI API:
https://gate.joingonka.ai/v1 - Base URL per i client Anthropic API, senza
/v1:https://gate.joingonka.ai - La chiave si passa nell'header
Authorization: Bearer jg-…oppurex-api-key: jg-… - Elenco dei modelli disponibili:
GET https://gate.joingonka.ai/v1/models - Modello consigliato:
MiniMaxAI/MiniMax-M2.7
Collega lo strumento#
Scegli il tuo strumento: qui sotto trovi i tre passaggi specifici per quello. L'installer configura con un solo comando gli strumenti nella tabella sottostante (25 in tutto); per gli altri segui la guida.
Claude Code
Chiave
Registrati su gate.joingonka.ai e crea una chiave nella tua area personale. Subito dopo la registrazione ricevi 3M token gratuiti sul conto.
Ottieni la chiave APIConnessione
L'installer configura Claude Code da solo: chiede la chiave con input nascosto, scrive il file di configurazione e verifica la connessione con una richiesta al gateway.
Bashnpx -y @joingonka/setup --tool claude-code --model MiniMaxAI/MiniMax-M2.7Oppure affida la configurazione a un agente AI: inviagli questo prompt:
Prompt per l'agenteCollega Claude Code a JoinGonka Gateway, l'API compatibile con OpenAI e Anthropic della rete Gonka, seguendo le istruzioni su https://gate.joingonka.ai/docs/agents.md. La chiave te la fornisco io: non salvarla nei file del repository e non modificare le variabili d'ambiente globali. Alla fine verifica la connessione con una breve richiesta e riporta il risultato.Guida passo passo: Claude Code.
Verifica
Saldo del conto: questa richiesta non consuma token:
cURLcurl -s https://gate.joingonka.ai/api/balance \ -H "Authorization: Bearer $JOINGONKA_API_KEY"Breve richiesta al modello: una risposta con codice 200 significa che è tutto configurato:
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}'
Tutti gli strumenti#
| Strumento | Tipo | Installer |
|---|---|---|
| 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 |
Esempi di codice#
La stessa richiesta con OpenAI SDK, cURL e Anthropic SDK. La chiave viene presa dalla variabile d'ambiente 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)Sezioni della documentazione#
- API — Riferimento dell'API compatibile con OpenAI e Anthropic per i modelli della rete Gonka: chiavi, parametri, streaming, strumenti, plugin. Token gratuiti alla registrazione.
- Modelli — I modelli della rete Gonka in un'unica API: id per il campo model, contesto, limite di risposta, prezzi e stato. Gli stessi modelli aperti a una frazione del prezzo.
- Errori e limiti — Codici di errore del gateway, limiti di richieste e timeout: cosa significa ogni risposta e quando ripetere la richiesta.
- Piani e account — I modelli della rete Gonka al prezzo per token: token gratuiti per iniziare, ricarica con GNK, USDT o carta, tutte le commissioni in chiaro e API account per monitorare le spese.
- Per gli agenti — Passa il link a un agente AI — collegherà da solo Claude Code, Cursor o Codex ai modelli della rete Gonka: prompt pronto, guida e skill.