JoinGonka Gateway — Visão geral completa

JoinGonka Gateway é uma camada intermediária entre seu aplicativo e a rede Gonka. Arquitetura:

1. Seu aplicativo envia uma solicitação para gate.joingonka.ai/v1/chat/completions (formato OpenAI) ou gate.joingonka.ai/v1/messages (formato Anthropic).
2. Gateway aceita a solicitação em qualquer um dos dois formatos, verifica a chave API e o saldo, e a redireciona para a rede Gonka.
3. A rede Gonka processa a solicitação em um dos ~582 nós de ML com o modelo Qwen3-235B.
4. Gateway recebe a resposta, calcula os tokens consumidos, debita o saldo e retorna a resposta ao seu aplicativo — no mesmo formato em que a solicitação foi recebida (OpenAI ou Anthropic).

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

Por que o Gateway é necessário se existe a API direta da Gonka? A API direta da Gonka requer uma carteira de criptomoedas, assinatura de transações GNK e compreensão da blockchain. JoinGonka Gateway elimina essa complexidade: você paga em uma moeda conveniente (GNK, USDT, fiat), obtém o formato API familiar do OpenAI ou Anthropic, usa o Dashboard para monitoramento — sem nenhum conhecimento sobre criptomoedas.

Pilha tecnológica: Fastify (Node.js), PostgreSQL, nginx. Gateway processa até 1000 solicitações/seg, suporta streaming (SSE em ambos os formatos), tool calling e todos os parâmetros da API OpenAI Chat Completions + Anthropic Messages. Tempo adicionado à latência — menos de 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.

No mercado, existem vários gateways para a rede Gonka e, claro, provedores centralizados. Vamos comparar:

API Anthropic — apenas JoinGonka. Nenhum outro gateway para Gonka suporta a API Anthropic Messages (/v1/messages). Isso significa que as ferramentas que funcionam via formato Anthropic — Claude Code, Cline (no modo Anthropic) — se conectam a Gonka apenas via JoinGonka Gateway.

Por que JoinGonka Gateway e não GonkaGate? GonkaGate aceita apenas GNK — é preciso comprar tokens na bolsa, ter uma carteira de criptomoedas, assinar transações. Além disso, GonkaGate suporta apenas o formato OpenAI. JoinGonka Gateway aceita USDT (5% de comissão), fiat via On-Ramp e GNK (0% de comissão). Além disso: Dashboard com análise, programa de indicação (10% L1 + 3% L2), suporte a tool calling, e ambos os formatos de API — OpenAI e Anthropic.

Por que não Gonka Broker? Gonka Broker cobra um markup de 389x — $0.35 por 1M tokens, com um custo base de $0.0009. Ainda é mais barato que OpenAI, mas 389 vezes mais caro do que o necessário. JoinGonka Gateway opera com o markup mínimo.

Oito vantagens principais:

1. A API OpenAI + Anthropic compatível com IA mais barata: $0.001/1M tokens — 2800 vezes mais barata que OpenAI GPT-4o. Para a maioria das tarefas, a diferença na qualidade é insignificante, mas o custo é drasticamente diferente.
2. Dois formatos de API — OpenAI e Anthropic: /v1/chat/completions (OpenAI) e /v1/messages (Anthropic) — ambos funcionam com uma única chave. Cursor, LangChain, openai SDK — via formato OpenAI. Claude Code — via formato Anthropic, diretamente, sem proxy. Nenhum concorrente oferece isso.
3. Tool calling nativo: Qwen3-235B suporta tool calling em ambos os formatos — OpenAI e Anthropic. Agentes, cadeias, automação — tudo funciona de forma confiável.
4. Início gratuito: 10M tokens no registro. Isso é suficiente para semanas de testes e primeiras integrações — sem pagamento.
5. Pagamento flexível: GNK (0% de comissão), USDT (5%), fiat via On-Ramp. Não é preciso entender criptomoedas — pode-se pagar com cartão.
6. Programa de indicação: 10% do gasto dos usuários indicados (L1) + 3% dos indicados deles (L2). Compartilhe o link — ganhe tokens.
7. Dashboard e análise: um CRM completo — saldo, gasto, histórico de solicitações, chaves API. Tudo em uma ú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):

• Recarga de GNK: 0% de comissão. Você envia GNK para o endereço do Gateway, o saldo é creditado instantaneamente.
• Recarga de USDT: 5% de comissão. Pague USDT (via OxaPay), o Gateway converte para GNK automaticamente. 5% — taxa de conveniência (não é necessária uma carteira de criptomoedas Gonka).
• Recarga de Fiat: via On-Ramp (cartão → USDT → GNK). A comissão depende do provedor On-Ramp.

Comissão da plataforma: uma comissão de 10% é aplicada ao custo base de inferência na rede Gonka. Essa comissão já está incluída no preço final de ~$0.001/1M tokens. O custo base na rede é de ~$0.0009/1M, com a comissão é de ~$0.001/1M. A comissão cobre os custos de infraestrutura do Gateway (servidores, DB, monitoramento).

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

Tool calling: chamadas de função (tools) também consomem tokens — 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 normal — mas a um preço de $0.001/1M, ainda é centavos.

Programa de indicação: cada usuário recebe um link de indicação exclusivo no Dashboard. Quando um usuário convidado gasta tokens — você recebe 10% do gasto dele (L1). Se o seu indicado também convidar pessoas — você recebe 3% do gasto delas (L2). Os créditos de indicação são em tokens GNK para o seu saldo.

Transparência: todas as transações são visíveis no Dashboard — recargas, débitos, créditos 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: o modelo atual Qwen3-235B suporta uma janela de contexto de 128K tokens. O comprimento máximo da resposta é de 2048 tokens (1024 por padrão). Parâmetros API suportados: model, messages, max_tokens, temperature, tools, tool_choice, stream.