Yapay zeka ajanları için: adım adım kurulum kılavuzu — /docs/agents.md, dokümantasyon dizini — /llms.txt.
Gonka modellerini aracına bağla
OpenAI ve Anthropic uyumlu API. Aracını seç – kurulum komutunu, ajan için promptu ve doğrulamayı al.
Hızlı bilgiler#
- OpenAI API istemcileri için temel adres:
https://gate.joingonka.ai/v1 - Anthropic API istemcileri için temel adres,
/v1olmadan:https://gate.joingonka.ai - Anahtar
Authorization: Bearer jg-…veyax-api-key: jg-…başlığında iletilir - Kullanılabilir modellerin listesi:
GET https://gate.joingonka.ai/v1/models - Önerilen model:
MiniMaxAI/MiniMax-M2.7
Araç bağla#
Aracını seç – aşağıda tam da onun için üç adım var. Kurulum betiği aşağıdaki tablodaki araçları (25 adet) tek komutla yapılandırır, diğerleri rehberle bağlanır.
Claude Code
Anahtar
gate.joingonka.ai üzerinde kaydol ve hesabında bir anahtar oluştur. Kaydolduktan hemen sonra hesabına 3M ücretsiz token tanımlanır.
API anahtarı alBağlantı
Kurulum betiği Claude Code aracını kendisi yapılandırır: anahtarı gizli girişle sorar, yapılandırmayı yazar ve ağ geçidine bir istekle bağlantıyı doğrular.
Bashnpx -y @joingonka/setup --tool claude-code --model MiniMaxAI/MiniMax-M2.7Ya da kurulumu bir yapay zeka ajanına bırak – ona şu promptu gönder:
Ajan için promptClaude Code aracını Gonka ağının OpenAI ve Anthropic uyumlu API'si olan JoinGonka Gateway'e https://gate.joingonka.ai/docs/agents.md adresindeki talimata göre bağla. Anahtarı ben vereceğim: depo dosyalarına kaydetme ve genel ortam değişkenlerini değiştirme. Sonunda kısa bir istekle bağlantıyı doğrula ve sonucu bildir.Adım adım rehber: Claude Code.
Doğrulama
Hesap bakiyesi – bu istek token harcamaz:
cURLcurl -s https://gate.joingonka.ai/api/balance \ -H "Authorization: Bearer $JOINGONKA_API_KEY"Modele kısa bir istek – 200 kodlu yanıt her şeyin ayarlandığı anlamına gelir:
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}'
Tüm araçlar#
| Araç | Tür | Kurulum |
|---|---|---|
| Cursor | IDE | --tool cursor |
| Claude Code | CLI ajanı | --tool claude-code |
| OpenClaw | CLI ajanı | --tool openclaw |
| OpenCode | CLI ajanı | --tool opencode |
| Continue | IDE | --tool continue |
| Cline | IDE | --tool cline |
| Aider | CLI ajanı | --tool aider |
| LangChain | Framework | — |
| n8n | Framework | — |
| Open WebUI | Sohbet | — |
| LibreChat | Sohbet | — |
| Hermes | CLI ajanı | --tool hermes |
| Kilo Code | IDE | --tool kilo |
| Roo Code | IDE | --tool roo |
| LlamaIndex | Framework | — |
| PydanticAI | Framework | — |
| Vercel AI SDK | Framework | — |
| TanStack AI | Framework | — |
| ZCode | CLI ajanı | --tool zcode |
| JetBrains | IDE | --tool jetbrains |
| Copilot BYOK | IDE | --tool copilot-byok |
| Zed | IDE | --tool zed |
| Pi | CLI ajanı | --tool pi |
| Codex CLI | CLI ajanı | --tool codex |
| DeepSeek Harness | CLI ajanı | — |
| MiniMax Code | CLI ajanı | --tool minimax-code |
| Warp | CLI ajanı | — |
| Trae | IDE | — |
| Cherry Studio | Sohbet | — |
| omp (Oh My Pi) | CLI ajanı | --tool omp |
| OpenHands | CLI ajanı | — |
| Qwen Code | CLI ajanı | --tool qwen-code |
| Goose | CLI ajanı | --tool goose |
| Crush | CLI ajanı | --tool crush |
| Zoo Code | IDE | --tool zoo |
| Kimi Code | CLI ajanı | --tool kimi-code |
| Factory Droid | CLI ajanı | --tool droid |
| MiMo Code | CLI ajanı | --tool mimo-code |
Kod örnekleri#
Aynı istek OpenAI SDK, cURL ve Anthropic SDK ile. Anahtar JOINGONKA_API_KEY ortam değişkeninden alınır.
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)Dokümantasyon bölümleri#
- API — Gonka ağındaki modellere yönelik OpenAI ve Anthropic uyumlu API referansı: anahtarlar, parametreler, akış, araçlar, eklentiler. Kayıtta ücretsiz tokenlar.
- Modeller — Gonka ağındaki modeller tek bir API'de: model alanı için id, bağlam, yanıt limiti, fiyatlar ve durum. Aynı açık modeller kat kat daha ucuza.
- Hatalar ve Limitler — Gateway hata kodları, istek limitleri ve zaman aşımları: her yanıtın anlamı ve isteği ne zaman tekrarlaman gerektiği.
- Fiyatlandırma ve Hesap — Gonka ağındaki modeller token başına fiyatla: başlangıçta ücretsiz tokenlar, GNK, USDT veya kartla bakiye yükleme, tüm komisyonlar açık ve harcamaları takip etmek için hesap API'si.
- Ajanlar İçin — Linki yapay zeka ajanına ver — Claude Code, Cursor veya Codex'i Gonka ağındaki modellere kendisi bağlar: hazır prompt, kılavuz ve yetenek.