Dla agentów AI: instrukcja konfiguracji krok po kroku — /docs/agents.md, indeks dokumentacji — /llms.txt.

Podłącz modele Gonka do swojego narzędzia

API zgodne z OpenAI i Anthropic. Wybierz narzędzie — otrzymasz polecenie instalacji, prompt dla agenta i weryfikację.

Szybkie fakty#

  • Adres bazowy dla klientów OpenAI API: https://gate.joingonka.ai/v1
  • Adres bazowy dla klientów Anthropic API, bez /v1: https://gate.joingonka.ai
  • Klucz przekazywany jest w nagłówku Authorization: Bearer jg-… lub x-api-key: jg-…
  • Lista dostępnych modeli: GET https://gate.joingonka.ai/v1/models
  • Zalecany model: MiniMaxAI/MiniMax-M2.7

Podłącz narzędzie#

Wybierz swoje narzędzie — poniżej trzy kroki właśnie dla niego. Instalator konfiguruje jedną komendą narzędzia z tabeli poniżej (jest ich 25), pozostałe podłącza się według przewodnika.

Claude Code

  1. Klucz

    Zarejestruj się na gate.joingonka.ai i utwórz klucz w panelu klienta. Zaraz po rejestracji na konto trafia 3M darmowych tokenów.

    Pobierz klucz API
  2. Podłączenie

    Instalator skonfiguruje Claude Code samodzielnie: zapyta o klucz ukrytym wprowadzaniem, zapisze konfigurację i sprawdzi połączenie zapytaniem do bramy.

    Bash
    npx -y @joingonka/setup --tool claude-code --model MiniMaxAI/MiniMax-M2.7

    Możesz też zlecić konfigurację agentowi AI — wyślij mu ten prompt:

    Prompt dla agenta
    Podłącz Claude Code do JoinGonka Gateway — API sieci Gonka zgodnego z OpenAI i Anthropic — według instrukcji https://gate.joingonka.ai/docs/agents.md. Klucz podam sam: nie zapisuj go w plikach repozytorium i nie zmieniaj globalnych zmiennych środowiskowych. Na koniec sprawdź połączenie krótkim zapytaniem i poinformuj o wyniku.

    Przewodnik krok po kroku: Claude Code.

  3. Weryfikacja

    Saldo konta — to zapytanie nie zużywa tokenów:

    cURL
    curl -s https://gate.joingonka.ai/api/balance \
      -H "Authorization: Bearer $JOINGONKA_API_KEY"

    Krótkie zapytanie do modelu — odpowiedź z kodem 200 oznacza, że wszystko jest skonfigurowane:

    cURL
    curl -s 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": "Say OK"}], "max_tokens": 32}'

Wszystkie narzędzia#

NarzędzieTypInstalator
CursorIDE--tool cursor
Claude CodeAgent CLI--tool claude-code
OpenClawAgent CLI--tool openclaw
OpenCodeAgent CLI--tool opencode
ContinueIDE--tool continue
ClineIDE--tool cline
AiderAgent CLI--tool aider
LangChainFramework—
n8nFramework—
Open WebUICzat—
LibreChatCzat—
HermesAgent CLI--tool hermes
Kilo CodeIDE--tool kilo
Roo CodeIDE--tool roo
LlamaIndexFramework—
PydanticAIFramework—
Vercel AI SDKFramework—
TanStack AIFramework—
ZCodeAgent CLI--tool zcode
JetBrainsIDE--tool jetbrains
Copilot BYOKIDE--tool copilot-byok
ZedIDE--tool zed
PiAgent CLI--tool pi
Codex CLIAgent CLI--tool codex
DeepSeek HarnessAgent CLI—
MiniMax CodeAgent CLI--tool minimax-code
WarpAgent CLI—
TraeIDE—
Cherry StudioCzat—
omp (Oh My Pi)Agent CLI--tool omp
OpenHandsAgent CLI—
Qwen CodeAgent CLI--tool qwen-code
GooseAgent CLI--tool goose
CrushAgent CLI--tool crush
Zoo CodeIDE--tool zoo
Kimi CodeAgent CLI--tool kimi-code
Factory DroidAgent CLI--tool droid
MiMo CodeAgent CLI--tool mimo-code

Przykłady kodu#

To samo zapytanie przez OpenAI SDK, cURL i Anthropic SDK. Klucz pobierany jest ze zmiennej środowiskowej 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)

Sekcje dokumentacji#

  • API — Dokumentacja API zgodnego z OpenAI i Anthropic dla modeli sieci Gonka: klucze, parametry, streaming, narzędzia, wtyczki. Darmowe tokeny przy rejestracji.
  • Modele — Modele sieci Gonka w jednym API: id dla pola model, kontekst, limit odpowiedzi, ceny i status. Te same otwarte modele wielokrotnie taniej.
  • Błędy i limity — Kody błędów bramy, limity zapytań i limity czasu: co oznacza każda odpowiedź i kiedy ponowić zapytanie.
  • Cennik i konto — Modele sieci Gonka w cenie za token: darmowe tokeny na start, doładowanie GNK, USDT lub kartą, wszystkie opłaty jawnie i API konta do śledzenia wydatków.
  • Dla agentów — Przekaż link agentowi AI — sam podłączy Claude Code, Cursor lub Codex do modeli sieci Gonka: gotowy prompt, instrukcja i skill.