Para agentes de IA: guia passo a passo de configuração — /docs/agents.md, índice da documentação — /llms.txt.

Conecte os modelos da Gonka à sua ferramenta

API compatível com OpenAI e Anthropic. Escolha a ferramenta e receba o comando de instalação, o prompt para o agente e a verificação.

• URL base para clientes da OpenAI API: https://gate.joingonka.ai/v1Copiar
• URL base para clientes da Anthropic API, sem /v1: https://gate.joingonka.aiCopiar
• A chave é enviada no cabeçalho Authorization: Bearer jg-… ou x-api-key: jg-…
• Lista de modelos disponíveis: GET https://gate.joingonka.ai/v1/models
• Modelo recomendado: MiniMaxAI/MiniMax-M2.7Copiar

Escolha a sua ferramenta e veja abaixo os três passos específicos para ela. O instalador configura com um único comando as ferramentas da tabela abaixo (25); as demais são conectadas seguindo o guia.

Todas as ferramentas#

A mesma requisição pelo SDK da OpenAI, cURL e SDK da Anthropic. A chave é lida da variável de ambiente JOINGONKA_API_KEY.

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://gate.joingonka.ai/v1",
    api_key=os.environ["JOINGONKA_API_KEY"],
)

response = client.chat.completions.create(
    model="MiniMaxAI/MiniMax-M2.7",
    messages=[{"role": "user", "content": "What is Gonka?"}],
)
print(response.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://gate.joingonka.ai/v1",
  apiKey: process.env.JOINGONKA_API_KEY,
});

const response = await client.chat.completions.create({
  model: "MiniMaxAI/MiniMax-M2.7",
  messages: [{ role: "user", content: "What is Gonka?" }],
});
console.log(response.choices[0].message.content);

curl https://gate.joingonka.ai/v1/chat/completions \
  -H "Authorization: Bearer $JOINGONKA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMaxAI/MiniMax-M2.7",
    "messages": [{"role": "user", "content": "What is Gonka?"}]
  }'

import os
import anthropic

client = anthropic.Anthropic(
    base_url="https://gate.joingonka.ai",
    api_key=os.environ["JOINGONKA_API_KEY"],
)

message = client.messages.create(
    model="MiniMaxAI/MiniMax-M2.7",
    max_tokens=1024,
    messages=[{"role": "user", "content": "What is Gonka?"}],
)
print(message.content[0].text)

• API — Referência da API compatível com OpenAI e Anthropic para os modelos da rede Gonka: chaves, parâmetros, streaming, ferramentas, plugins. Tokens grátis ao se cadastrar.
• Modelos — Os modelos da rede Gonka em uma única API: id para o campo model, contexto, limite de resposta, preços e status. Os mesmos modelos abertos por uma fração do preço.
• Erros e limites — Códigos de erro do gateway, limites de requisições e timeouts: o que significa cada resposta e quando repetir a requisição.
• Preços e conta — Modelos da rede Gonka com preço por token: tokens grátis para começar, recarga com GNK, USDT ou cartão, todas as taxas às claras e API de conta para acompanhar seus gastos.
• Para agentes — Envie o link ao seu agente de IA e ele conecta o Claude Code, o Cursor ou o Codex aos modelos da rede Gonka sozinho: prompt pronto, guia e skill.