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-… oppure x-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

  1. 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 API
  2. Connessione

    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.

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

    Oppure affida la configurazione a un agente AI: inviagli questo prompt:

    Prompt per l'agente
    Collega 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.

  3. Verifica

    Saldo del conto: questa richiesta non consuma token:

    cURL
    curl -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:

    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}'

Tutti gli strumenti#

StrumentoTipoInstaller
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

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)

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.