Bilgi Tabanı Bölümleri ▾

Navigasyon

▸ Buradan başlayın Rol bazlı

Kategoriler

Araçlar 52
Sözlük 12

Araçlar

Warp + JoinGonka Gateway — kendi endpoint'inizde terminal ajanı

Warp, bir ajan tabanlı geliştirme ortamına dönüşen bir terminaldir: yerleşik Warp Agent, komut çıktılarını okur, dosyaları düzenler, derlemeleri başlatır ve bir görevi talepten sonuca kadar yürütür. Varsayılan olarak ajan, Warp'ın kendi sattığı modellerde (tarif kredileri karşılığında) çalışır. Kendi inference endpoint'inizi getirmek uzun süre sadece ücretli planlarda ve sadece OpenAI, Anthropic veya Google anahtarlarıyla mümkündü. 20 Mayıs 2026'da Warp, ücretsiz tarifede BYOK özelliğini açtı ve custom inference endpoint (özel çıkarım uç noktası) ekledi; bu, OpenAI Chat Completions konuşan her türlü servisi bağlamanıza olanak tanır.

İkinci yöntem, Warp ajanını JoinGonka Gateway üzerinden çalıştırmak için gereklidir: ağ geçidi, merkeziyetsiz Gonka ağının modellerini OpenAI uyumlu bir API üzerinden sunar, çıkarım ağın güncel fiyatları üzerinden ödenir ve bireysel kullanıcılar ile küçük ekiplerin Warp kredileri bu süreçte harcanmaz. Kayıt olup adresinizi doğruladıktan sonra hesabınıza 3M ücretsiz token yüklenecektir; bu miktar, ilk yüklemenizi yapmadan önce ajanı kendi görevlerinizde denemeniz için yeterlidir.

Aşağıda, başlamadan önce nelere ihtiyacınız olduğu, Warp formuna hangi değerlerin girileceği, isteklerin ağ geçidinden geçtiğinden nasıl emin olunacağı, terminal görevleri için hangi ağ modelinin seçilmesi gerektiği ve istek rotası hakkında bilmeniz gereken önemli detaylar yer almaktadır: Warp'ta bu yapı, çoğu araçtan farklı çalışır.

İhtiyaç duyulanlar: anahtar, Warp tarifesi ve herkese açık adres

JoinGonka anahtarı. Ağ geçidine kaydolun, panelde "API-keys" bölümünü açın ve "Create key" (Anahtar oluştur) butonuna tıklayın. Anahtar jg- ile başlar ve yalnızca bir kez gösterilir; hemen kaydedin. Warp için ayrı bir anahtar oluşturmak kullanışlıdır: bu sayede "Usage" bölümünde terminal ajanının tüketimi diğer araçlarla karışmadan ayrı bir satır olarak görülebilir.

Warp tarifesi. Kendi endpoint'iniz sadece ücretli planlarda değil, ekip büyüklüğüne bağlı olarak şu şartlarla kullanılabilir:

BağlayanÖzel endpoint kullanılabilir mi?Warp kredileri durumu
Tek geliştirici veya 10 kişiye kadar şirket (Free, Build, Max planları)Evet, bu planların herhangi birindeKendi endpoint'iniz üzerinden yapılan çıkarım işlemleri için kredi düşülmez
10 kişiden büyük organizasyonSadece Business veya EnterpriseYerel ajan çalıştırmaları platform credits harcar (indirimli oranda Warp altyapı ücreti); çıkarım işleminin kendisi ise endpoint sağlayıcısına ödenir

Herkesin erişebileceği HTTPS adresi. Bu, tahmin etmesi kolay olmayan bir Warp gereksinimidir: endpoint'inize gelen istekleri makinenizdeki uygulama değil, Warp sunucuları gönderir; bu nedenle adres internetten erişilebilir olmalıdır. localhost, 127.0.0.1 ve özel ağ adresleri form tarafından reddedilir ve şema sadece https:// olarak kabul edilir. JoinGonka Gateway herkese açık bir HTTPS servisidir, bu nedenle Warp dokümantasyonunda yerel modeller için önerilen ngrok gibi tünellere burada gerek yoktur.

Güncel uygulama sürümü. Özel endpoint, 20 Mayıs 2026 tarihli kararlı sürümden itibaren mevcuttur; formda API şeması seçimi ise 31 Temmuz 2026 tarihli sürümle eklenmiştir. Formda API schema alanı yoksa Warp'ı güncelleyin.

Bağlantı: Add custom endpoint formu

Tüm kurulum uygulama arayüzünden yapılır — dosyaları elle düzenlemenize gerek yok.

  1. Settings'i açın ve ayar aramasına inference endpoint yazın — Warp, sağlayıcı anahtarları ile kendi endpoint'lerinin bulunduğu bloğa gider (bu blok Warp Agent ayarlar sayfasındadır).
  2. Add custom endpoint'e tıklayın — bir form açılır.
  3. Alanları tablodaki değerlerle doldurun ve Add endpoint'e tıklayın.
Form alanıNe yazılacakAçıklama
API schemaOpenAI Chat CompletionsVarsayılan şema: Warp belgeleri adres formatını tam da bunun için açıklar. Listede ayrıca OpenAI Responses ve Anthropic Messages da var
Endpoint nameJoinGonkaHerhangi bir ad — endpoint ayarlarda bu adla görünür
Endpoint URLhttps://gate.joingonka.ai/v1/v1 dahil temel adres — Warp belgelerindeki örnekte olduğu gibi
API keyjg-your-keyYalnızca cihazda, sistem anahtar deposunda saklanır
Model namedeepseek-ai/DeepSeek-V4-Flash-0731Modelin ağ geçidinin verdiği tam kimliği
Model alias (optional)DeepSeek V4 FlashModel değiştirici için kısa ad

+ Add model düğmesi bir sonraki satırı ekler. Ağdaki tüm modelleri hemen tanımlayın ki sonradan ayarlara dönmeden aralarında geçiş yapabilesiniz: deepseek-ai/DeepSeek-V4-Flash-0731, MiniMaxAI/MiniMax-M2.7 ve zai-org/GLM-5.3-Flash. Güncel listeyi her zaman GET https://gate.joingonka.ai/v1/models verir. Kimlikleri harfi harfine yazın: form yalnızca adresin biçimini ve alanların dolu olup olmadığını kontrol eder, kaydederken deneme isteği yapmaz; dolayısıyla model adındaki bir yazım hatası ancak ajanla diyalogda ortaya çıkar.

Kaydettikten sonra modeller ajanın model değiştiricisinde görünür. Varsayılan model olarak Warp modellerinden biri kalmışsa uygulama değiştirmeyi kendisi önerebilir — kabul edin ve kendi endpoint'inizin modelini seçin. Önemli bir ayrıntı: değiştiricideki Auto seçenekleri her zaman Warp altyapısında çalışır ve kendi endpoint'iniz yapılandırılmış olsa bile onun kredilerini harcar. İsteğin ağ geçidine gitmesi için değiştiricide listenizden belirli bir modelin seçili olması gerekir.

Kontrol: İstekler ağ geçidi üzerinden mi gidiyor?

Anahtardan endpoint'inizin modelini seçin ve ajana kısa bir görev verin, örneğin: «Geçerli dizindeki en büyük beş dosyayı göster ve komutu açıkla.» Ajan bir komut önermeli, sizin onayınızla çalıştırmalı ve çıktıyı yorumlamalı.

Şimdi gateway panelini, «Kullanım» bölümünü açın. «Anahtarlara göre» bloğunda Warp için oluşturduğunuz anahtarın istekleri ve son erişim zamanı, «Modellere göre» bloğunda ise seçilen model görünecek. Sayaçlar artıyorsa inference Warp kredileri üzerinden değil, JoinGonka Gateway üzerinden akıyor demektir. Warp ise token harcamasını doğrudan ajanla olan diyalogda gösterir – alias alanında verdiğiniz kısa adların altında.

Bir şeyler ters gittiyse nedeni genellikle yanıttan okunur:

GörünenAnlamıYapılması gereken
401, Invalid API keyGateway anahtarı tanımadıAnahtarın jg- ile başladığını, boşluk olmadan yapıştırıldığını ve «API anahtarları» bölümünde etkin olduğunu kontrol edin; şüpheniz varsa yeni bir tane oluşturun
404, Invalid URL (POST …)Yol fazladan bir segmentle oluşturulmuş; hata metninde gateway isteğin tam olarak nereye geldiğini gösterirSonuç /v1/chat/completions olmalı. /v1 ikiye katlanmışsa veya adrese tam yol girmişse – Endpoint URL'yi yukarıdaki tablodaki biçime getirin
405 Not Allowed veya yanıt yerine bir HTML sayfasıAdreste /v1 eksik, istek API'nin dışına düştüAdresin sonuna /v1 ekleyin
429Model aşırı yüklü: yoğun saatlerde ağdaki belirli bir modelin kapasitesi tamamen tükenebiliyorBirkaç saniye sonra tekrar deneyin veya komşu bir modele geçin – hepsini birden oluşturmanın nedeni de bu
İstekler geçiyor ama Warp kredileri eriyorAnahtarda endpoint modeli değil, Auto veya Warp'in model yönlendiricisi seçiliKendi listenizden belirli bir model seçin
Form adresi kabul etmiyorWarp https:// ve herkese açık bir host gerektiriyorGateway adresini https:// ile başlayarak tam olarak yazın
Model eklenen resmi «görmüyor»Ağın modelleri metin tabanlı: gateway görseli bir metin etiketiyle değiştirirEkran görüntüsü gerektiren görevler için görü yeteneği olan bir modele geçin, komutlar ve kod için ağın modelinde kalın
Bulut çalıştırmada endpoint modeli yokKendi endpoint'iniz yerel olarak saklanır ve Cloud Agents için geçerli değildirGörevi yerel ajanla çalıştırın

Oturumdaki ilk yanıt birkaç saniyelik gecikmeyle gelebilir: ajan araçların tanımını içeren büyük bir sistem prompt'u gönderir ve istek önce Warp sunucularından, ardından ağın bir düğümünden geçer. Sonrasında diyalog daha hızlı ilerler.

Terminal ajanı için hangi model seçilmeli

Ağ modellerinin fiyatı aynıdır, bu nedenle seçim bütçe ile ilgili değil davranış ile ilgilidir. Terminal ajanı çok fazla okuma yapar (komut çıktıları, loglar, dosyalar) ve sürekli araçları çağırır; tablodaki tüm modeller yerel tool calling desteğine sahiptir.

ModelTanımlayıcıBağlam ve YanıtWarp'ta ne zaman kullanılır
DeepSeek V4 Flashdeepseek-ai/DeepSeek-V4-Flash-0731380K, 32768 tokene kadar yanıtAjan için varsayılan model: uzun oturumlar, büyük loglar ve diff'ler, birden fazla dosyadaki düzeltmeler. Bağlam kapasitesi ve ağdaki en yüksek yanıt limiti
MiniMax M2.7MiniMaxAI/MiniMax-M2.7200K, 8192 tokene kadar yanıtHızlı kısa görevler: komut bulma, hata ayıklama, yapılandırma düzeltme
GLM-5.3 Flashzai-org/GLM-5.3-Flash390K, 8192 tokene kadar yanıtAkıl yürütme (reasoning) modeli: yanıt vermeden önce düşünür. Karmaşık hata ayıklama, migrasyon planı, yabancı kod analizi; yanıt daha geç gelir ve yanıt limitinin bir kısmı akıl yürütme için kullanılır

Pratik şema: DeepSeek V4 Flash — ana model, MiniMax M2.7 — ufak işler için, GLM-5.3 Flash — görev hacimle değil mantıkla ilgili olduğunda. Tüm modeller endpoint'te tanımlı olduğu için geçiş yapmak bir saniye sürer ve alias alanındaki kısa isimler uzun tanımlayıcılar arasında karışıklığı önler. En popüler olanı hakkında daha fazla bilgi için DeepSeek V4 Flash incelemesine göz atın.

Maliyeti ne kadar

Terminaldeki ajanın token tüketimi, sohbetten daha yüksektir: Warp her isteğe sistem talimatlarını, diyalog bağlamını ve araç açıklamalarını ekler ve bir görev birkaç adımdan oluşur. Bu yüzden burada token başına fiyat, normal yazışmalardan daha önemlidir.

JoinGonka Gateway üzerinden tokenlar giriş için $0.0069 ve çıkış için $0.021 milyon token başına maliyete sahiptir — fiyat ağdaki tüm modeller için aynıdır ve bu sayfaya canlı bir kaynaktan çekilir. Eylül 2026 fiyatları için yaklaşık tutarlar:

SenaryoTüketimGateway üzerinden
Tek seferlik görev: komut ve çıktı analizion binlerce tokensentin kesirleri
Ajanla aktif bir çalışma günü3-7M tokenbirkaç sent
Günlük aylık çalışma~150M tokenbir-iki dolar civarı

Karşılaştırma için — Warp ajanı için ödeme yapmanın üç yolu:

YöntemÇıkarımı (inference) kim hesaplarNe sınırlar
Warp modelleriWarp, tarife kredileriylePlanın aylık kredi limiti
BYOK: OpenAI, Anthropic veya Google anahtarıModel sağlayıcısı kendi fiyatıylaSağlayıcının milyon token başına fiyatı
Kendi endpoint'iniz + JoinGonka GatewayGateway: token başına, bakiyedenSadece bakiye: tüketim panelde görülür, istek sayısı kotası yoktur

Warp'ın kendisi, bireyler ve 10 kişiye kadar olan ekipler için kendi endpoint'leri üzerinden yapılan çalışmalardan kredi kesmez — sadece Gateway'deki tokenlar için ödeme yaparsınız. Bakiye panelden yüklenir, orada kalan tutar ile gün ve modele göre tüketim detayları görülebilir.

İstek rotası ve gizlilik: bilinmesi gerekenler

Çoğu araçta kendi endpoint'iniz olması, „isteklerin benim makinelerimden doğrudan sağlayıcıya gitmesi“ anlamına gelir. Warp'ta durum farklıdır: Aracının (agent) yürütme kısmı Warp sunucularında çalışır ve kendi endpoint'iniz yalnızca nihai hedefi ve anahtarı değiştirir. Warp dokümantasyonuna göre istek yolu şu şekildedir:

  1. Uygulama, endpoint adresini ve anahtarı cihazdaki güvenli depolama alanından alır ve prompt'unuzla birlikte Warp sunucularına gönderir.
  2. Warp tarafındaki aracı, sistem talimatları, diyalog bağlamı ve araçlar dahil olmak üzere tam isteği birleştirir ve bu anahtarla endpoint'inizi çağırır.
  3. Yanıt, aynı sunucular üzerinden akış (stream) halinde uygulamaya geri döner.

Bunun pratikteki anlamı şudur:

  • Anahtar. Sadece cihazda saklanır. Her istekte Warp sunucularından geçer, ancak Warp'ın beyanına göre burada saklanmaz: anlık olarak kullanılır ve atılır.
  • Prompt'lar ve Yanıtlar. Warp arka ucu üzerinden geçiş yapar. Warp, bu içeriği eğitim için kullanmadığını beyan eder; depolama ve analizler, hesabınızın gizlilik ve telemetri ayarlarına tabidir. Warp'ın kendi modelleri için geçerli olan ZDR garantisi, kendi endpoint'inize genişletilemez: sağlayıcının neyi saklayacağına sağlayıcı karar verir.
  • Ağ Geçidi (Gateway) Tarafı. JoinGonka Gateway diyalogları saklamaz: yanıt verildikten sonra prompt'lar ve yanıtlar ağ geçidinde kalmaz; panelde yalnızca istek ve token sayaçları görünür.
  • Warp Altyapısında Kalanlar. Otomatik (Auto) seçenekler, kullanıcı tanımlı model yönlendiricileri, Codebase Context, Active AI önerileri ve bulut aracıları — kendi endpoint'iniz bunlar üzerinde bir etkiye sahip değildir.

Eğer görevleriniz için üçüncü taraf sunucular üzerinden geçen bir yol kabul edilemezse, doğrudan makinenizden endpoint'e erişen bir aracı kullanın — örneğin Codex CLI veya API hızlı başlangıç kılavuzundaki herhangi bir araç. Warp, duyurusunda bir istemci tarafı seçeneği de vaat ediyor: açık kaynaklı bir depoda, Warp sunucularından rota oluşturmadan yerel modellere bağlanacak hafif bir Rust tabanlı aracı modülü ve Agent Client Protocol desteği. 2 Eylül 2026 sürümünden itibaren, endpoint açıklamaları uygulama ve Warp Agent CLI için ortak bir ayar dosyasında saklanmaktadır; anahtarlar bu dosyaya girmez ve güvenli depolama alanında kalır.

Warp, Add custom endpoint formu aracılığıyla JoinGonka Gateway'e bağlanır: OpenAI Chat Completions şeması, https://gate.joingonka.ai/v1 adresi, jg- anahtarı ve ağın model kimlikleri. Bireyler ve 10 kişiye kadar olan ekipler için bu, ücretsiz planda bile mevcuttur ve Uç nokta (endpoint) modeli seçili olduğu sürece (Auto değil), Warp çıkarım (inference) kredileri harcanmaz. Warp'ın ana özelliği rotadır: uç noktaya yönelik istekler sunucuları tarafından gönderilir, bu nedenle adresin herkese açık olması gerekir ve istemler Warp arka ucu üzerinden geçişli olarak iletilir. Terminal görevleri için DeepSeek V4 Flash, küçük işler için MiniMax M2.7, karmaşık mantık için GLM-5.3 Flash kullanın.

Daha fazla bilgi edinmek ister misiniz?

Diğer bölümleri keşfedin veya şimdi GNK kazanmaya başlayın.

Anahtar ve ücretsiz token alın →