JoinGonka Gateway — panoramica completa

JoinGonka Gateway è uno strato 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 riceve 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 nodi ML, dove è distribuito il modello selezionato — MiniMax M2.7, DeepSeek V4 Flash o GLM-5.3 Flash.
4. Gateway riceve la risposta, conteggia i token consumati, addebita il saldo e restituisce la risposta alla tua applicazione nello stesso formato in cui è stata ricevuta la richiesta (OpenAI o Anthropic).

Due formati API: Gateway supporta sia OpenAI Chat Completions API (/v1/chat/completions) che 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 Gonka diretta? L'API Gonka diretta richiede un portafoglio crittografico, la firma delle transazioni GNK e la comprensione della blockchain. JoinGonka Gateway rimuove questa complessità: paghi nella valuta che preferisci (GNK, WGNK, USDT, fiat), ottieni il familiare formato API OpenAI o Anthropic e utilizzi la Dashboard per il monitoraggio — senza alcuna conoscenza sulle criptovalute.

Stack tecnico: Fastify (Node.js), PostgreSQL, nginx. Gateway gestisce fino a 1000 richieste/sec, supporta lo streaming (SSE in entrambi i formati), tool calling e tutti i parametri di OpenAI Chat Completions + Anthropic Messages API. Il tempo di latenza aggiuntivo è inferiore a 50ms.

L'intero processo richiede 2 minuti:

1. Registrazione: vai su gate.joingonka.ai/register. Email + password — il modulo standard.
2. Bonus: alla registrazione ricevi automaticamente 3M token gratuiti. Bastano per migliaia di richieste all'AI — sufficienti per i test e le prime integrazioni.
3. Creazione della chiave: in Dashboard → API Keys → Create Key. La chiave inizia con jg-, ad esempio jg-abc123def456. Viene mostrata una sola volta — salvala.
4. Prima richiesta: usa la chiave con qualsiasi client compatibile con OpenAI o Anthropic. Per il formato OpenAI sostituisci base_url con https://gate.joingonka.ai/v1. Per il formato Anthropic (Claude Code) — ANTHROPIC_BASE_URL=https://gate.joingonka.ai.

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

Dashboard: nella tua area personale vedi: il saldo token attuale, la cronologia delle richieste, la spesa giornaliera, le API key, il link di referral. Un vero CRM per gestire le spese AI.

Gli stessi modelli open che distribuisce la rete decentralizzata Gonka sono disponibili anche su piattaforme di inference tradizionali, ad esempio OpenRouter. La differenza sta nel costo. Confrontiamo il prezzo per 1M di token degli stessi modelli:

Lo stesso modello, da ~6 a 58 volte più economico. JoinGonka Gateway offre MiniMax-M2.7, DeepSeek-V4-Flash (380K di contesto, il secondo più lungo nella rete dopo i 390K di GLM-5.3-Flash) e GLM-5.3-Flash a ~$0.0069 in input e ~$0.021 in output per 1M di token (l'output costa il triplo, come per altri provider). Sulle piattaforme comuni gli stessi pesi del modello costano da ~6 a 58 volte di più: la ragione è l'architettura — in Gonka l'inference viene pagata dai miner tramite Proof of Useful Work e non tramite il margine di un data center.

Non solo il prezzo. JoinGonka Gateway fornisce entrambi i formati API — OpenAI (/v1/chat/completions) e Anthropic (/v1/messages), così Claude Code si collega direttamente tramite il formato nativo Anthropic. In più: tool calling nativo, Dashboard con analytics, pagamenti flessibili (GNK 0%, WGNK 1%, USDT 5%, fiat) e un programma referral (10% L1 + 3% L2).

Otto vantaggi chiave:

1. L'API più economica compatibile con OpenAI + Anthropic: $0.0069/1M token — da ~720 volte più economica di OpenAI GPT-5.5. Per la maggior parte dei compiti la differenza di qualità è impercettibile, ma quella di costo è drastica.
2. Due formati API — OpenAI e Anthropic: /v1/chat/completions (OpenAI) e /v1/messages (Anthropic) — entrambi funzionano con un'unica chiave. Cursor, LangChain, openai SDK — tramite formato OpenAI. Claude Code — tramite formato Anthropic, direttamente, senza proxy. Nessun concorrente offre tutto questo.
3. Native tool calling: tutti i modelli della rete supportano il function calling in entrambi i formati — OpenAI e Anthropic. Agenti, catene, automazione — tutto funziona in modo affidabile.
4. Inizio gratuito: 3M di token alla registrazione. Sono sufficienti per settimane di test e per le prime integrazioni, senza pagamenti.
5. Pagamenti flessibili: GNK (commissione 0%), WGNK da Ethereum (1%), USDT (5%), fiat tramite On-Ramp. Non serve destreggiarsi tra le criptovalute — si può pagare con carta.
6. Programma referral: 10% della spesa degli utenti invitati (L1) + 3% dai loro referral (L2). Condividi il link, guadagna token.
7. Dashboard e analytics: un CRM completo — saldo, spese, cronologia richieste, API-keys. Tutto in un'unica interfaccia.
8. Piena compatibilità con l'ecosistema: funziona con qualsiasi client compatibile OpenAI (Cursor, n8n, LangChain) e Anthropic (Claude Code) — senza modifiche.

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

• Ricarica GNK: commissione 0%. Inviando GNK all'indirizzo Gateway, il saldo viene accreditato istantaneamente.
• Ricarica WGNK: commissione 1%. Per i GNK sulla rete Ethereum, il trasferimento viene accreditato automaticamente.
• Ricarica USDT: commissione 5%. Pagando in USDT (tramite OxaPay), il Gateway converte automaticamente in GNK. Il 5% è una commissione di comodità (non è necessario un crypto-wallet Gonka).
• Ricarica fiat: tramite On-Ramp (carta → USDT → GNK). La commissione dipende dal provider On-Ramp.

Commissione della piattaforma: sul costo base dell'inference nella rete Gonka viene applicata una commissione del 10%. Questa commissione è già inclusa nel prezzo finale di ~$0.0069/1M token. Il costo base sulla rete è di ~$0.0046/1M, con la commissione - ~$0.0069/1M. La commissione copre le spese dell'infrastruttura Gateway (server, database, monitoraggio).

Come viene calcolato il consumo: ogni richiesta API (sia in formato OpenAI che Anthropic) consuma token dal saldo unificato. Il Gateway calcola prompt_tokens (in ingresso) + completion_tokens (in uscita) e li addebita sul saldo. Costo: $0.0069 per 1M di token (~0.003 GNK al tasso 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 richiesta tipica di tool calling consuma 1.5-3 volte più token rispetto a una normale, ma al prezzo di $0.0069/1M rimane comunque estremamente economico.

Programma di affiliazione: ogni utente riceve un link di riferimento unico nella Dashboard. Quando un utente invitato consuma token, ricevi il 10% del suo consumo (L1). Se il tuo referral invita a sua volta altre persone, ricevi il 3% del loro consumo (L2). Gli accrediti di affiliazione sono in token GNK direttamente sul tuo saldo.

Trasparenza: tutte le transazioni sono visibili nella Dashboard: ricariche, addebiti, accrediti di affiliazione. L'API restituisce un oggetto usage con ogni risposta: saprai sempre quanti token ha consumato la richiesta.

Parametri del modello: la finestra di contesto è di 200K token per MiniMax M2.7, 380K per DeepSeek V4 Flash e 390K per GLM-5.3 Flash. La lunghezza massima della risposta è fino a 8192 token (per DeepSeek V4 Flash fino a 32768; di default senza max_tokens - 1500). Parametri API supportati: model, messages, max_tokens, temperature, tools, tool_choice, stream.