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 inferência convencionais — como o OpenRouter. A diferença é o preço cobrado. Vamos comparar o custo por 1M de tokens dos mesmos modelos:

O mesmo modelo — 40 a 190 vezes mais barato. O JoinGonka Gateway disponibiliza o MiniMax-M2.7, Kimi-K2.6 e DeepSeek-V4-Flash (380K de contexto — o maior da rede) por ~$0.0047 na entrada e ~$0.014 na saída por 1M de tokens (a saída é três vezes mais cara — como em outros provedores). Em plataformas convencionais, os mesmos pesos de modelo custam de 40 a 190 vezes mais: o motivo é a arquitetura — no Gonka, a inferência é paga pelos mineradores via Proof of Useful Work, e não por margens de data center.

Não apenas o preço. O JoinGonka Gateway oferece ambos os formatos de API — OpenAI (/v1/chat/completions) e Anthropic (/v1/messages), então o Claude Code se conecta diretamente via formato nativo da Anthropic. Além de 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.0047/1M tokens — cerca de 800 vezes mais barata que a OpenAI GPT-5.5. Para a maioria das tarefas, a diferença é impercetível na qualidade, mas drástica no custo.
2. Dois formatos de API — OpenAI e Anthropic: /v1/chat/completions (OpenAI) e /v1/messages (Anthropic) — ambos funcionam com a mesma chave. Cursor, LangChain, openai SDK — via formato OpenAI. Claude Code — via formato Anthropic, diretamente, sem proxy. Nenhum concorrente oferece isto.
3. Tool calling nativo: O Kimi K2.6 suporta function calling em ambos os formatos — OpenAI e Anthropic. Agentes, cadeias, automação — tudo funciona de forma fiável.
4. Início gratuito: 1.5M tokens no registo. Isto é suficiente para semanas de testes e as primeiras integrações — sem pagamentos.
5. Pagamento flexível: GNK (0% comissão), USDT (5%), fiat via On-Ramp. Não precisa de entender de criptomoedas — pode pagar com cartão.
6. Programa de referências: 10% do gasto dos utilizadores referidos (L1) + 3% dos referidos deles (L2). Partilhe o link e ganhe tokens.
7. Dashboard e análise: uma CRM completa — saldo, gastos, histórico de pedidos, chaves API. Tudo numa única interface.
8. Compatibilidade total 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):

• Depósito de GNK: 0% de comissão. Você envia GNK para o endereço do Gateway, o saldo é creditado instantaneamente.
• Depósito de USDT: 5% de comissão. Pague com USDT (via OxaPay), o Gateway converte para GNK automaticamente. Os 5% são uma taxa de conveniência (não é necessária uma crypto-wallet Gonka).
• Depósito fiat: via On-Ramp (cartão → USDT → GNK). A comissão depende do provedor de On-Ramp.

Comissão da plataforma: uma comissão de 10% é aplicada ao custo base da inferência na rede Gonka. Esta comissão já está incluída no preço final de ~$0.0047/1M tokens. O custo base na rede é de ~$0.0046/1M, com a comissão é de ~$0.0047/1M. A comissão cobre as despesas de infraestrutura do Gateway (servidores, banco de dados, monitoramento).

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

Tool calling: 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 de 1.5 a 3 vezes mais tokens que uma normal, mas ao preço de $0.0047/1M, isso ainda é insignificante.

Programa de afiliados: cada usuário recebe um link de indicação exclusivo no Dashboard. Quando um usuário convidado consome tokens, você recebe 10% do consumo dele (L1). Se o seu referido também convidar pessoas, você recebe 3% do consumo delas (L2). As recompensas de indicação são pagas em tokens GNK no seu saldo.

Transparência: todas as transações são visíveis no Dashboard — depósitos, débitos e recompensas de indicação. 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 da API suportados: model, messages, max_tokens, temperature, tools, tool_choice, stream.