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 open-weights distribuiti dalla rete decentralizzata Gonka sono disponibili anche su piattaforme di inference tradizionali, come OpenRouter. La differenza sta nel prezzo. Confrontiamo il costo per 1M di token degli stessi modelli:

Lo stesso modello — da 40 a 190 volte più economico. JoinGonka Gateway offre MiniMax-M2.7, Kimi-K2.6 e DeepSeek-V4-Flash (380K di contesto — il più lungo della rete) a ~$0.0047 in ingresso e ~$0.014 in uscita per 1M di token (l'output costa il triplo, come per altri provider). Sulle piattaforme comuni, gli stessi pesi dei modelli costano da 40 a 190 volte di più: la ragione è l'architettura — in Gonka, l'inference è pagata dai miner tramite Proof of Useful Work e non tramite il margine del data center.

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

Otto vantaggi chiave:

1. L'API compatibile OpenAI + Anthropic più economica: $0.0047/1M token — circa 800 volte più economica di OpenAI GPT-5.5. Per la maggior parte dei task 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 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: Kimi K2.6 supporta il function calling in entrambi i formati — OpenAI e Anthropic. Agenti, catene, automazione — tutto funziona in modo affidabile.
4. Avvio gratuito: 1.5M token alla registrazione. Sufficienti per settimane di test e prime integrazioni — senza pagamenti.
5. Pagamento flessibile: GNK (0% commissioni), USDT (5%), fiat tramite On-Ramp. Non è necessario gestire 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 analisi: CRM completo — saldo, consumi, cronologia richieste, API-key. Tutto in un'unica interfaccia.
8. Piena compatibilità con l'ecosistema: funziona con qualsiasi client compatibile OpenAI (Cursor, n8n, LangChain) e client compatibile Anthropic (Claude Code) — senza modifiche.

La fatturazione di JoinGonka Gateway utilizza i token GNK (unità interna):

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

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

Calcolo dell'utilizzo: ogni richiesta API (sia in formato OpenAI che in formato Anthropic) consuma token da un unico saldo. Il Gateway conteggia prompt_tokens (in entrata) + completion_tokens (in uscita) e li scala dal saldo. Costo: $0.0047 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 richiesta normale, ma al prezzo di $0.0047/1M rimane estremamente conveniente.

Programma referral: 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). Le commissioni di riferimento vengono accreditate in token GNK sul tuo saldo.

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

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