JoinGonka Gateway — panoramica completa

JoinGonka Gateway è un livello intermedio tra la tua applicazione e la rete Gonka. Architettura:

1. La tua applicazione invia una richiesta a gate.joingonka.ai/v1/chat/completions (formato OpenAI) o gate.joingonka.ai/v1/messages (formato Anthropic).
2. Gateway accetta la richiesta in uno dei due formati, verifica la chiave API e il saldo, e la inoltra alla rete Gonka.
3. La rete Gonka elabora la richiesta su uno dei ~582 ML-node con il modello Kimi K2.6.
4. Gateway riceve la risposta, conta i token consumati, addebita il saldo e restituisce la risposta alla tua applicazione — nello stesso formato in cui la richiesta è stata ricevuta (OpenAI o Anthropic).

Due formati API: Gateway supporta sia l'OpenAI Chat Completions API (/v1/chat/completions) che l'Anthropic Messages API (/v1/messages). Ciò significa che strumenti come Cursor e LangChain funzionano tramite il formato OpenAI, mentre Claude Code si collega direttamente tramite il formato Anthropic — senza proxy o convertitori.

Perché serve un Gateway se esiste un'API diretta di Gonka? L'API diretta di Gonka richiede un crypto-wallet, la firma delle transazioni GNK e la comprensione della blockchain. JoinGonka Gateway elimina questa complessità: paghi nella valuta che preferisci (GNK, USDT, fiat), ottieni il familiare formato API OpenAI o Anthropic, utilizzi la Dashboard per il monitoraggio — senza alcuna conoscenza in ambito cripto.

Tech stack: Fastify (Node.js), PostgreSQL, nginx. Gateway gestisce fino a 1000 richieste/sec, supporta lo streaming (SSE in entrambi i formati), il tool calling e tutti i parametri delle API OpenAI Chat Completions + Anthropic Messages. L'aumento della latenza è inferiore a 50ms.

L'intero processo richiede 2 minuti:

1. Registrazione: vai su gate.joingonka.ai/register. Email + password — modulo standard.
2. Bonus: al momento della registrazione, ti vengono accreditati automaticamente 10.000.000 di token gratuiti. Questo è sufficiente per migliaia di richieste AI — abbastanza per test e le prime integrazioni.
3. Creazione di una chiave: nella Dashboard → API Keys → Create Key. La chiave inizia con jg-, ad esempio jg-abc123def456. Viene visualizzata una sola volta — salvala.
4. Prima richiesta: usa la chiave in qualsiasi client compatibile con OpenAI o Anthropic. Per il formato OpenAI, cambia base_url in https://gate.joingonka.ai/v1. Per il formato Anthropic (Claude Code) — ANTHROPIC_BASE_URL=https://gate.joingonka.ai.

Istruzioni pronte per gli strumenti più popolari: Cursor, Claude Code, Aider, Continue.dev, Cline, LangChain, n8n, Open WebUI, LibreChat. Esempi di codice (curl, Python, TypeScript) — nella guida rapida API.

Dashboard: nel tuo account personale vedi: saldo token attuale, cronologia richieste, spesa giornaliera, chiavi API, link di referral. Questo è un CRM completo per la gestione delle spese AI.

Gli stessi modelli aperti distribuiti dalla rete decentralizzata Gonka sono disponibili anche su comuni piattaforme di inferenza, come ad esempio OpenRouter. La differenza sta nei costi. Confrontiamo il prezzo per 1M di token per gli stessi modelli:

Lo stesso modello, centinaia di volte più economico. JoinGonka Gateway offre MiniMax-M2.7 e Kimi-K2.6 a ~$0.003 per l'input e ~$0.009 per l'output per 1M di token (l'output costa il triplo, proprio come presso altri fornitori). Sulle comuni piattaforme, gli stessi pesi del modello costano centinaia di volte di più: il motivo risiede nell'architettura. In Gonka, l'inferenza viene pagata dai miner tramite Proof of Useful Work, non tramite il margine del data center.

Non solo prezzo. JoinGonka Gateway fornisce entrambi i formati API, OpenAI (/v1/chat/completions) e Anthropic (/v1/messages), in modo che Claude Code si connetta direttamente tramite il formato nativo di Anthropic. Inoltre, offre tool calling nativo, Dashboard con analisi, pagamenti flessibili (GNK 0%, USDT 5%, fiat) e un programma di referral (10% L1 + 3% L2).

Otto vantaggi chiave:

1. L'API più economica compatibile con OpenAI + Anthropic: $0.003/1M di token, ben 930 volte più economica di OpenAI GPT-5.5. Per la maggior parte dei compiti, la differenza di qualità è impercettibile, ma il risparmio sui costi è drastico.
2. Due formati API — OpenAI e Anthropic: /v1/chat/completions (OpenAI) e /v1/messages (Anthropic) — entrambi funzionano con una singola chiave. Cursor, LangChain, openai SDK utilizzano il formato OpenAI; Claude Code usa il formato Anthropic, direttamente, senza proxy. Nessun concorrente offre tutto questo.
3. Tool calling nativo: Kimi K2.6 supporta il function calling in entrambi i formati, OpenAI e Anthropic. Agent, catene, automazione: tutto funziona in modo affidabile.
4. Inizio gratuito: 10M di token alla registrazione. Sufficienti per settimane di test e prime integrazioni, senza pagamenti.
5. Pagamenti flessibili: GNK (commissione 0%), USDT (5%), fiat tramite On-Ramp. Non è necessario capire le criptovalute: puoi pagare con carta.
6. Programma di referral: 10% di quanto speso dagli utenti invitati (L1) + 3% dai loro referral (L2). Condividi il link e guadagna token.
7. Dashboard e analisi: CRM completo — saldo, consumi, cronologia richieste, API-keys. Tutto in un'unica interfaccia.
8. Piena compatibilità con l'ecosistema: funziona con qualsiasi client compatibile con OpenAI (Cursor, n8n, LangChain) e Anthropic (Claude Code) senza alcuna modifica.

La fatturazione di JoinGonka Gateway avviene in token GNK (unità interna):

• Ricarica GNK: commissione 0%. Inviando GNK all'indirizzo del Gateway, il saldo viene accreditato istantaneamente.
• Ricarica USDT: commissione 5%. Paghi in USDT (tramite OxaPay), il Gateway converte automaticamente in GNK. Il 5% è una commissione di servizio (non è necessario un crypto-wallet Gonka).
• Ricarica fiat: tramite On-Ramp (carta → USDT → GNK). La commissione dipende dal fornitore On-Ramp.

Commissione della piattaforma: al costo base dell'inferenza nella rete Gonka viene applicata una commissione del 10%. Questa commissione è già inclusa nel prezzo finale di ~$0.003/1M di token. Il costo base di rete è di circa ~$0.0027/1M, con commissione arriva a ~$0.003/1M. La commissione copre le spese per l'infrastruttura del Gateway (server, database, monitoraggio).

Come calcoliamo il consumo: ogni richiesta API (sia formato OpenAI che Anthropic) consuma token da un saldo unico. Il Gateway conta prompt_tokens (input) + completion_tokens (output) e li scala dal saldo. Prezzo: $0.003 per 1M di token (~0.003 GNK al tasso di cambio attuale). Una chiave, un saldo, per entrambi i formati API.

Tool calling: anche le chiamate alle funzioni (tools) consumano token: le definizioni delle funzioni vengono aggiunte al prompt. Una tipica richiesta di tool calling consuma 1.5-3 volte più token rispetto a una normale, ma al prezzo di $0.003/1M rimane estremamente conveniente.

Programma di referral: ogni utente riceve un link di referral unico nella Dashboard. Quando un utente invitato spende token, ricevi il 10% della sua spesa (L1). Se il tuo referral invita a sua volta qualcuno, ricevi il 3% della sua spesa (L2). I premi referral vengono accreditati in token GNK sul tuo saldo.

Trasparenza: tutte le transazioni sono visibili nella Dashboard: ricariche, addebiti, premi referral. L'API restituisce un oggetto usage con ogni risposta, così sai sempre quanti token ha consumato la richiesta.

Parametri del modello: i modelli di rete supportano una finestra di contesto di 200K token. La lunghezza massima della risposta è fino a 8192 token (per tutti i modelli di rete; il default senza max_tokens è 1500). Parametri API supportati: model, messages, max_tokens, temperature, tools, tool_choice, stream.