JoinGonka Gateway — Visão geral completa

O JoinGonka Gateway é uma camada intermediária entre sua aplicação e a rede Gonka. Arquitetura:

1. Sua aplicação envia uma solicitação para gate.joingonka.ai/v1/chat/completions (formato OpenAI) ou gate.joingonka.ai/v1/messages (formato Anthropic).
2. Gateway recebe a solicitação em qualquer um dos dois formatos, verifica a API-key e o saldo, e a redireciona para a rede Gonka.
3. Rede Gonka processa a solicitação em um dos ~582 ML-nodes com o modelo Kimi K2.6.
4. Gateway recebe a resposta, contabiliza os tokens consumidos, debita o saldo e retorna a resposta para sua aplicação — no mesmo formato em que a solicitação foi recebida (OpenAI ou Anthropic).

Dois formatos de API: O Gateway suporta tanto a OpenAI Chat Completions API (/v1/chat/completions) quanto a Anthropic Messages API (/v1/messages). Isso significa que ferramentas como Cursor e LangChain funcionam através do formato OpenAI, enquanto o Claude Code se conecta diretamente através do formato Anthropic — sem proxies ou conversores.

Por que é necessário um Gateway se existe uma API direta da Gonka? A API direta da Gonka exige uma carteira cripto, assinatura de transações GNK e conhecimento sobre blockchain. O JoinGonka Gateway elimina essa complexidade: você paga na moeda de sua preferência (GNK, USDT, fiat), recebe o formato de API habitual da OpenAI ou Anthropic e utiliza o Dashboard para monitoramento — sem necessidade de conhecimentos sobre criptomoedas.

Stack técnico: Fastify (Node.js), PostgreSQL, nginx. O Gateway processa até 1000 solicitações/seg, suporta streaming (SSE em ambos os formatos), tool calling e todos os parâmetros da OpenAI Chat Completions + Anthropic Messages API. O tempo de latência adicionado é inferior a 50ms.

Todo o processo leva 2 minutos:

1. Registro: acesse gate.joingonka.ai/register. E-mail + senha — formulário padrão.
2. Bônus: ao se registrar, são creditados automaticamente 10.000.000 tokens gratuitos. Isso é suficiente para milhares de solicitações de IA — o suficiente para testes e primeiras integrações.
3. Criação de chave: em Dashboard → API Keys → Create Key. A chave começa com jg-, por exemplo, jg-abc123def456. É exibida apenas uma vez — salve-a.
4. Primeira solicitação: use a chave em qualquer cliente compatível com OpenAI ou Anthropic. Para o formato OpenAI, altere base_url para https://gate.joingonka.ai/v1. Para o formato Anthropic (Claude Code) — ANTHROPIC_BASE_URL=https://gate.joingonka.ai.

Instruções prontas para ferramentas populares: Cursor, Claude Code, Aider, Continue.dev, Cline, LangChain, n8n, Open WebUI, LibreChat. Exemplos de código (curl, Python, TypeScript) — no Início Rápido da API.

Dashboard: na sua conta pessoal, você verá: saldo atual de tokens, histórico de solicitações, consumo diário, chaves API, link de referência. É um CRM completo para gerenciar gastos com IA.

Os mesmos modelos abertos distribuídos pela rede descentralizada Gonka também estão disponíveis em plataformas de inference convencionais — por exemplo, no OpenRouter. A diferença reside em quanto eles cobram por isso. Vamos comparar o preço por 1M de tokens dos mesmos modelos:

O mesmo modelo — centenas de vezes mais barato. O JoinGonka Gateway oferece o MiniMax-M2.7 e o Kimi-K2.6 por ~$0.003 na entrada e ~$0.009 na saída por 1M de tokens (a saída é três vezes mais cara — assim como em outros provedores). Em plataformas convencionais, os mesmos pesos de modelo custam centenas de vezes mais: a razão está na arquitetura — no Gonka, o inference é pago pelos mineradores via Proof of Useful Work, e não por margem de data center.

Não apenas o preço. O JoinGonka Gateway fornece ambos os formatos de API — OpenAI (/v1/chat/completions) e Anthropic (/v1/messages), então o Claude Code se conecta diretamente pelo formato nativo da Anthropic. Além disso, há tool calling nativo, Dashboard com análises, pagamento flexível (GNK 0%, USDT 5%, fiat) e programa de afiliados (10% L1 + 3% L2).

Oito vantagens principais:

1. A API compatível com OpenAI + Anthropic mais barata: $0.003/1M de tokens — 930 vezes mais barata que a OpenAI GPT-5.5. Para a maioria das tarefas, a diferença de qualidade é imperceptível, mas a economia de custos é drástica.
2. Dois formatos de API — OpenAI e Anthropic: /v1/chat/completions (OpenAI) e /v1/messages (Anthropic) — ambos funcionam com uma única chave. Cursor, LangChain e a SDK da openai funcionam via formato OpenAI. O Claude Code funciona via formato Anthropic, diretamente, sem proxy. Nenhum concorrente oferece isso.
3. Tool calling nativo: O Kimi K2.6 suporta function calling em ambos os formatos — OpenAI e Anthropic. Agentes, cadeias e automação — tudo funciona de forma confiável.
4. Início gratuito: 10M de tokens ao registrar-se. Isso é o suficiente para semanas de testes e as primeiras integrações — sem pagamento.
5. Pagamento flexível: GNK (0% de taxa), USDT (5%), fiat via On-Ramp. Não é preciso entender de criptomoedas — você pode pagar com cartão.
6. Programa de afiliados: 10% do gasto dos usuários convidados (L1) + 3% dos afiliados deles (L2). Compartilhe o link — ganhe tokens.
7. Dashboard e análises: um CRM completo — saldo, gastos, histórico de solicitações, chaves de API. Tudo em uma interface.
8. Total compatibilidade com o ecossistema: funciona com qualquer cliente compatível com OpenAI (Cursor, n8n, LangChain) e cliente compatível com Anthropic (Claude Code) — sem modificações.

O faturamento do JoinGonka Gateway funciona em tokens GNK (unidade interna):

• Recarga GNK: 0% de taxa. Você envia GNK para o endereço do Gateway e o saldo é creditado instantaneamente.
• Recarga USDT: 5% de taxa. Você paga em USDT (via OxaPay) e o Gateway converte automaticamente para GNK. Os 5% são uma taxa de conveniência (não precisa de carteira Gonka).
• Recarga fiat: via On-Ramp (cartão → USDT → GNK). A taxa depende do provedor On-Ramp.

Taxa da plataforma: uma taxa de 10% é aplicada ao custo básico de processamento na rede Gonka. Essa taxa já está incluída no preço final de ~$0.003/1M tokens. O custo básico na rede é de ~$0.0027/1M, com a taxa fica ~$0.003/1M. A taxa cobre os custos de infraestrutura do Gateway (servidores, DB, monitoramento).

Como o gasto é calculado: cada solicitação à API (tanto no formato OpenAI quanto no Anthropic) consome tokens de um saldo unificado. O Gateway calcula prompt_tokens (entrada) + completion_tokens (saída) e desconta do saldo. Custo: $0.003 por 1M de tokens (~0.003 GNK na cotação atual). Uma chave, um saldo — para ambos os formatos de API.

Tool calling: as chamadas de função (tools) também consomem tokens — as definições de função são adicionadas ao prompt. Uma solicitação típica de tool calling consome 1.5-3x mais tokens do que uma comum — mas, ao preço de $0.003/1M, isso ainda é irrisório.

Programa de afiliados: cada usuário recebe um link de afiliado exclusivo no Dashboard. Quando um usuário convidado gasta tokens, você recebe 10% dos gastos dele (L1). Se o seu afiliado indicar outras pessoas, você recebe 3% dos gastos delas (L2). As comissões de afiliados são pagas em tokens GNK diretamente no seu saldo.

Transparência: todas as transações são visíveis no Dashboard — depósitos, deduções, comissões de afiliados. A API retorna um objeto usage com cada resposta — você sempre sabe quantos tokens a solicitação consumiu.

Parâmetros do modelo: os modelos da rede suportam uma janela de contexto de 200K tokens. O comprimento máximo de resposta é de até 8192 tokens (para todos os modelos da rede; o padrão sem max_tokens é 1500). Parâmetros de API suportados: model, messages, max_tokens, temperature, tools, tool_choice, stream.