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-…lubx-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
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 APIPodłączenie
Instalator skonfiguruje Claude Code samodzielnie: zapyta o klucz ukrytym wprowadzaniem, zapisze konfigurację i sprawdzi połączenie zapytaniem do bramy.
Bashnpx -y @joingonka/setup --tool claude-code --model MiniMaxAI/MiniMax-M2.7Możesz też zlecić konfigurację agentowi AI — wyślij mu ten prompt:
Prompt dla agentaPodłą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.
Weryfikacja
Saldo konta — to zapytanie nie zużywa tokenów:
cURLcurl -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:
cURLcurl -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ędzie | Typ | Instalator |
|---|---|---|
| Cursor | IDE | --tool cursor |
| Claude Code | Agent CLI | --tool claude-code |
| OpenClaw | Agent CLI | --tool openclaw |
| OpenCode | Agent CLI | --tool opencode |
| Continue | IDE | --tool continue |
| Cline | IDE | --tool cline |
| Aider | Agent CLI | --tool aider |
| LangChain | Framework | — |
| n8n | Framework | — |
| Open WebUI | Czat | — |
| LibreChat | Czat | — |
| Hermes | Agent CLI | --tool hermes |
| Kilo Code | IDE | --tool kilo |
| Roo Code | IDE | --tool roo |
| LlamaIndex | Framework | — |
| PydanticAI | Framework | — |
| Vercel AI SDK | Framework | — |
| TanStack AI | Framework | — |
| ZCode | Agent CLI | --tool zcode |
| JetBrains | IDE | --tool jetbrains |
| Copilot BYOK | IDE | --tool copilot-byok |
| Zed | IDE | --tool zed |
| Pi | Agent CLI | --tool pi |
| Codex CLI | Agent CLI | --tool codex |
| DeepSeek Harness | Agent CLI | — |
| MiniMax Code | Agent CLI | --tool minimax-code |
| Warp | Agent CLI | — |
| Trae | IDE | — |
| Cherry Studio | Czat | — |
| omp (Oh My Pi) | Agent CLI | --tool omp |
| OpenHands | Agent CLI | — |
| Qwen Code | Agent CLI | --tool qwen-code |
| Goose | Agent CLI | --tool goose |
| Crush | Agent CLI | --tool crush |
| Zoo Code | IDE | --tool zoo |
| Kimi Code | Agent CLI | --tool kimi-code |
| Factory Droid | Agent CLI | --tool droid |
| MiMo Code | Agent 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)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)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.