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. Il Gateway riceve la richiesta in uno dei due formati, verifica la chiave API e il saldo, e la reindirizza alla rete Gonka.
3. La rete Gonka elabora la richiesta su uno dei ~582 ML-node con il modello Qwen3-235B.
4. Il Gateway riceve la risposta, calcola 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: Il Gateway supporta sia l'API OpenAI Chat Completions (/v1/chat/completions) che l'API Anthropic Messages (/v1/messages). Ciò significa che strumenti come Cursor e LangChain funzionano tramite il formato OpenAI, e Claude Code si collega direttamente tramite il formato Anthropic — senza proxy o convertitori.

Perché è necessario il Gateway se esiste un'API Gonka diretta? L'API Gonka diretta richiede un portafoglio crypto, la firma delle transazioni GNK e la comprensione della blockchain. JoinGonka Gateway elimina questa complessità: paghi in una valuta conveniente (GNK, USDT, fiat), ottieni un'API in formato OpenAI o Anthropic familiare, utilizzi il Dashboard per il monitoraggio — senza alcuna conoscenza sulle criptovalute.

Stack tecnologico: Fastify (Node.js), PostgreSQL, nginx. Il Gateway elabora fino a 1000 richieste/sec, supporta lo streaming (SSE in entrambi i formati), il tool calling e tutti i parametri di OpenAI Chat Completions + Anthropic Messages API. Il tempo aggiunto alla 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.

Sul mercato esistono diversi gateway per la rete Gonka e, naturalmente, provider centralizzati. Confrontiamoli:

Anthropic API — solo JoinGonka. Nessun altro gateway per Gonka supporta l'API Anthropic Messages (/v1/messages). Ciò significa che gli strumenti che operano tramite il formato Anthropic — Claude Code, Cline (in modalità Anthropic) — si connettono a Gonka solo tramite JoinGonka Gateway.

Perché JoinGonka Gateway, e non GonkaGate? GonkaGate accetta solo GNK — è necessario acquistare token su un exchange, avere un portafoglio crypto, firmare transazioni. Inoltre, GonkaGate supporta solo il formato OpenAI. JoinGonka Gateway accetta USDT (commissione 5%), fiat tramite On-Ramp e GNK (commissione 0%). Inoltre: una Dashboard con analisi, un programma di riferimento (10% L1 + 3% L2), supporto per il tool calling, e entrambi i formati API — OpenAI e Anthropic.

Perché non Gonka Broker? Gonka Broker prende un ricarico di 389x — $0.35 per 1M di token per un costo di $0.0009. È comunque più economico di OpenAI, ma 389 volte più costoso del necessario. JoinGonka Gateway opera con un ricarico minimo.

Otto vantaggi chiave:

1. L'API AI compatibile con OpenAI + Anthropic più economica: $0.001/1M di token — 2800 volte più economica di OpenAI GPT-4o. Per la maggior parte delle attività la differenza di qualità è impercettibile, ma quella di costo è radicale.
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 — tramite il formato OpenAI. Claude Code — tramite il formato Anthropic, direttamente, senza proxy. Nessun concorrente offre questo.
3. Tool calling nativo: Qwen3-235B supporta il function calling in entrambi i formati — OpenAI e Anthropic. Agenti, catene, automazione — tutto funziona in modo affidabile.
4. Inizio gratuito: 10M di token alla registrazione. Questo è sufficiente per settimane di test e le prime integrazioni — senza pagare.
5. Pagamento flessibile: GNK (0% di commissione), USDT (5%), fiat tramite On-Ramp. Non è necessario capire le criptovalute — puoi pagare con carta.
6. Programma di riferimento: 10% del consumo degli utenti invitati (L1) + 3% dei loro referral (L2). Condividi il link — guadagna token.
7. Dashboard e analisi: un CRM completo — saldo, consumo, cronologia delle richieste, chiavi API. Tutto in un'unica interfaccia.
8. Piena compatibilità con l'ecosistema: funziona con qualsiasi client compatibile con OpenAI (Cursor, n8n, LangChain) e client compatibile con Anthropic (Claude Code) — senza modifiche.

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

• Ricarica GNK: commissione 0%. Invii GNK all'indirizzo Gateway, il saldo viene accreditato istantaneamente.
• Ricarica USDT: commissione 5%. Paghi in USDT (tramite OxaPay), il Gateway converte automaticamente in GNK. 5% — costo per la convenienza (non è necessario un portafoglio crypto 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 circa $0.001/1M di token. Il costo base nella rete è di circa $0.0009/1M, con la commissione - circa $0.001/1M. La commissione copre i costi per l'infrastruttura del Gateway (server, DB, monitoraggio).

Come viene calcolato il consumo: ogni richiesta all'API (sia tramite il formato OpenAI che tramite il formato Anthropic) consuma token da un unico saldo. Il Gateway calcola prompt_tokens (input) + completion_tokens (output) e li deduce dal saldo. Costo: $0.001 per 1M di token (circa 0.001 GNK al tasso attuale). Una chiave, un saldo — per entrambi i formati API.

Tool calling: le chiamate di funzione (tools) consumano anch'esse token — le definizioni di funzione vengono aggiunte al prompt. Una tipica richiesta di tool calling consuma 1.5-3 volte più token di una normale — ma al prezzo di $0.001/1M sono comunque spiccioli.

Programma di riferimento: ogni utente riceve un link di riferimento unico nella Dashboard. Quando un utente invitato spende token — ricevi il 10% della sua spesa (L1). Se il tuo referral invita anche persone — ricevi il 3% della loro spesa (L2). I guadagni da referral — in token GNK sul tuo saldo.

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

Parametri del modello: il modello attuale Qwen3-235B supporta una finestra di contesto di 128K token. La lunghezza massima della risposta — 2048 token (predefinito 1024). Parametri API supportati: model, messages, max_tokens, temperature, tools, tool_choice, stream.