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, /v1 olmadan: https://gate.joingonka.ai
  • Anahtar Authorization: Bearer jg-… veya x-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

  1. 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ı al
  2. Bağ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.

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

    Ya da kurulumu bir yapay zeka ajanına bırak – ona şu promptu gönder:

    Ajan için prompt
    Claude 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.

  3. Doğrulama

    Hesap bakiyesi – bu istek token harcamaz:

    cURL
    curl -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:

    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}'

Tüm araçlar#

AraçTürKurulum
CursorIDE--tool cursor
Claude CodeCLI ajanı--tool claude-code
OpenClawCLI ajanı--tool openclaw
OpenCodeCLI ajanı--tool opencode
ContinueIDE--tool continue
ClineIDE--tool cline
AiderCLI ajanı--tool aider
LangChainFramework—
n8nFramework—
Open WebUISohbet—
LibreChatSohbet—
HermesCLI ajanı--tool hermes
Kilo CodeIDE--tool kilo
Roo CodeIDE--tool roo
LlamaIndexFramework—
PydanticAIFramework—
Vercel AI SDKFramework—
TanStack AIFramework—
ZCodeCLI ajanı--tool zcode
JetBrainsIDE--tool jetbrains
Copilot BYOKIDE--tool copilot-byok
ZedIDE--tool zed
PiCLI ajanı--tool pi
Codex CLICLI ajanı--tool codex
DeepSeek HarnessCLI ajanı—
MiniMax CodeCLI ajanı--tool minimax-code
WarpCLI ajanı—
TraeIDE—
Cherry StudioSohbet—
omp (Oh My Pi)CLI ajanı--tool omp
OpenHandsCLI ajanı—
Qwen CodeCLI ajanı--tool qwen-code
GooseCLI ajanı--tool goose
CrushCLI ajanı--tool crush
Zoo CodeIDE--tool zoo
Kimi CodeCLI ajanı--tool kimi-code
Factory DroidCLI ajanı--tool droid
MiMo CodeCLI 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)

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.