VANGU / BİLGİ BANKASI

Sıkça Sorulan Sorular

Model seçiminden ilk API isteğine, kota takibinden ödemeye kadar Vangu kullanım rehberi.

GÜNCEL MODEL KATALOĞU

Model kimlikleri ve kullanım alanları

Bu liste canlı katalogdan yenilenir. Anahtarınızın erişimi ve paket çarpanları için müşteri paneli ile GET /v1/models yanıtını esas alın.

GPT-6.1 Terra1.5x
gpt-6.1-terra

Görsel akıl yürütme, doğal metin üretimi ve genel amaçlı görevler.

GPT-6.1 Sol2x
gpt-6.1-sol

İleri düzey kodlama, hata ayıklama, mimari analiz ve çok adımlı akıl yürütme.

GPT-6 Astra4x
gpt-6-astra

Karmaşık analiz, araştırma ve derin akıl yürütme gerektiren görevler.

GPT-6 Sol2x
gpt-6-sol

Kodlama, araç kullanan ajanlar ve çok adımlı teknik görevler.

GPT-6 Luna1x
gpt-6-luna

Günlük sohbet, özetleme, sınıflandırma ve yüksek hacimli metin işlemleri.

GPT-5.6 Sol2x
gpt-5.6-sol

Kod üretimi, yapılandırılmış analiz ve mevcut iş akışlarıyla uyumlu kullanım.

GPT-5.6 Terra1.5x
gpt-5.6-terra

Genel metin üretimi, çeviri ve dengeli günlük görevler.

GPT-5.6 Luna1x
gpt-5.6-luna

Kısa yanıtlar, basit dönüşümler ve hafif asistan görevleri.

GPT Image 2Görsel
gpt-image-2

Görsel taslaklar, prototipler ve standart görsel üretimi.

GPT Image 2.5Görsel
gpt-image-2.5

Görsel üretimi ve düzenleme; Flare veya Sunburst modu seçilebilir.

GPT Image 2.5 FlareGörsel
gpt-image-2.5-flare

Flare moduna doğrudan erişim sağlayan görsel modeli kimliği.

GPT Image 2.5 SunburstGörsel
gpt-image-2.5-sunburst

Sunburst moduna doğrudan erişim sağlayan görsel modeli kimliği.

Kategori 01

Modeller ve model seçimi

Güncel model kimlikleri, 6.1 Sol, reasoning seviyeleri ve erişim hakları.

Vangu nedir, güncel model listesine nereden bakabilirim?

Vangu; sohbet, kodlama, ajan ve görsel iş akışlarını API üzerinden kullanabileceğiniz bir platformdur. Metin kataloğunda gpt-6.1-terra, gpt-6.1-sol, gpt-6-astra, gpt-6-sol, gpt-6-luna, gpt-5.6-sol, gpt-5.6-terra ve gpt-5.6-luna bulunur. Görsel modelleri aşağıdaki canlı katalogda gösterilir. Paketler sayfası satıştaki modelleri, API anahtarınızla GET /v1/models ise o anahtarın erişebildiği modelleri gösterir.

GPT-6.1 Terra ne için uygundur?

gpt-6.1-terra; görsel akıl yürütme, doğal metin üretimi ve genel amaçlı görevler için kullanılabilir. Metin ve görsel girdi alır, metin üretir; görsel üretim modeli değildir. Responses API ile araç çağrıları kullanılabilir. Desteklenen araçlar ve paketinizin kota kuralları geçerlidir.

GPT-6.1 Sol ile GPT-6 Sol aynı model mi?

Hayır. gpt-6.1-sol ve gpt-6-sol farklı model kimlikleridir. 6.1 Sol; ileri kodlama, hata ayıklama ve mimari analiz için katalogdaki yeni Sol seçeneğidir. İsteğin model alanına tam kimliği yazın; yalnız “sol” yazmak yerine paketinizde listelenen sürümü seçin. Model erişimi, fiyatı ve istek çarpanı ayrı alanlardır.

Hangi görev için hangi modeli seçmeliyim?

Kodlama ve teknik analiz için 6.1 Sol veya Sol ailesi; derin ve karmaşık analiz için Astra; kısa sohbet, özetleme ve sınıflandırma için Luna; genel metin ve çeviri için Terra seçeneklerini değerlendirin. Aynı küçük örnek görevde doğruluk, yanıt süresi ve token kullanımını karşılaştırın. Her görevde en yüksek modeli kullanmanız gerekmez.

Model çarpanı token fiyatıyla aynı şey mi?

Hayır. Kotalı paketlerde model çarpanı, bir isteğin istek havuzundan kaç birim düşeceğini belirler. Genel katalog örneğinde Luna 1x, Terra 1.5x, Sol/6.1 Sol 2x, Astra 4x seviyesindedir; satın aldığınız paketin katsayıları geçerlidir. Örneğin 2x bir çağrı 2 istek birimi tüketir. Kullandıkça öde modunda ise giriş, cached giriş ve çıktı tokenları USD tarifesiyle hesaplanır.

Düşünme seviyesi neyi değiştirir?

Desteklenen modellerde reasoning seviyesi, görev üzerinde ayrılan düşünme miktarını etkiler. Daha yüksek seviyeler daha uzun bekleme ve daha fazla çıktı/reasoning tokenı oluşturabilir. 6.1 Sol, 6 Sol ve Astra için düşük gecikme istediğinizde low, zor görevlerde uygun üst seviyeyi seçin. Modelin desteklemediği ayarları kullanmayın; kabul edilen seçenekleri dokümantasyondan kontrol edin.

Bir model katalogda olduğu hâlde anahtarımla neden çalışmayabilir?

Genel katalog, her paketin bütün modellere eriştiği anlamına gelmez. Aktif paketinizin modelleri, anahtarın model listesi ve uç nokta kapsamı, paket süresi, kalan kota veya bakiyeyi kontrol edin. GET /v1/models ve müşteri panelindeki paket ayrıntıları sizin erişiminiz için esas kaynaktır.

Kategori 02

Paketler, kotalar ve yenileme

Günlük, sınırsız, süreli ve ek paketlerin birbirinden farkı.

Günlük kota ne zaman yenilenir, haklar devreder mi?

Günlük kotalar Türkiye saatiyle 00.00 (UTC+3) sınırında yenilenir. Kullanılmayan günlük haklar ertesi güne devretmez. Haftalık veya aylık abonelik süresi, günlük kotanın yenilenme döneminden ayrıdır; paketinizin süresi bittiyse gece yenilenmesi erişimi tekrar başlatmaz.

Haftalık abonelik ile süreli istek paketi arasındaki fark nedir?

Haftalık abonelik, geçerlilik süresi içinde paketin günlük kurallarını uygular. Tek seferlik süreli istek paketi ise ürününde belirtilen ortak havuzu ve bitiş zamanını kullanır. Ek olarak tanımlanan günlük kotalı bir paketin kotası kendi geçerlilik süresince günlük yenilenebilir. Satın alma öncesinde kota türünü, yenilenme periyodunu ve geçerlilik süresini birlikte kontrol edin.

Sınırsız paketlerde hiç sınır yok mu?

“Sınırsız”, paketin metin istek kotasının sabit bir istek sayısıyla sınırlı olmadığı anlamına gelir. Eşzamanlılık, dahil modeller, görsel kotası, geçerlilik süresi ve varsa paket token limiti yine geçerlidir. Uç noktanın girdi/çıktı ve güvenli çalışma sınırları da korunur. Güncel koşullar paket kartında ve müşteri panelinizde gösterilir.

Paketimde token limiti varsa nasıl hesaplanır?

Tanımlı bir paket token limiti, paketin geçerlilik süresi boyunca toplam giriş ve çıkış tokenını kapsar. Aynı paketi kullanan API anahtarları ve sohbetler bu bütçeyi ortak tüketir; cached girişler de toplam girişe dahildir. Reasoning tokenları sağlayıcının çıktı toplamının içindedir ve bir kez sayılır. Bu toplam, günlük istek kotasından farklıdır.

Günlük kotayı erken yenileyebilir miyim?

Uygun günlük paketlerde panelde gösterilen erken yenileme hakkını kullanabilirsiniz. Varsayılan haftalık hak 2’dir; hesabınıza tanımlanan kalan hak panelde görünür ve Pazartesi yenilenir. Aynı gün tekrar kullanım sınırı vardır. Erken yenileme, birlikte yenilenen günlük paketlerin her birinden 1 gün geçerlilik düşürür; gerekli ek gün yoksa işlem yapılmaz.

Ek paket mevcut paketimi değiştirir mi?

Ek paket olarak tanımlanan hak, mevcut ana paketin yanında çalışır ve kendi bitiş tarihini korur. Model erişimi ve kullanılabilir kota, aktif haklara göre değerlendirilir. Günlük kotalı ana ve ek paketler birlikte erken yenilenirse ikisinin de süresinden 1 gün düşer. Ana paket olarak değiştirme işlemi ise ek paket tanımlamadan farklıdır.

Saatlik test paketi ne zaman başlar ve biter?

Yönetici tarafından saatlik tanımlanan paket, tanımlandığı anda başlar: 1 saat tam 60 dakikadır. Geçerlilik bitince paket erişimi sona erer; saatlik paket kendiliğinden haftalık/aylık aboneliğe yenilenmez. Saatlik paketler için yaklaşan bitiş veya süre dolumu e-postası gönderilmez.

Kategori 03

Eşzamanlılık ve akışlı yanıtlar

Aktif istekler, 429 yanıtı, SSE akışı ve uzun süren görevler.

Eşzamanlı istek limiti ne demektir?

Eşzamanlılık, hesabınız için aynı anda açık olabilen API isteklerinin sayısıdır. Tüm anahtarlarınız ve aynı hesabı kullanan uygulamalar ortak kapasiteyi kullanır. Akışlı isteğin içerik teslimi sürerken istek açık kalabilir; bu nedenle yalnız modelin üretim süresini saymak yeterli değildir. Paketinizin eşzamanlı sınırını panelden kontrol edin.

Kapasite doluyken istek sunucuda bekletilir mi?

Hayır. Eşzamanlı kapasite dolduğunda yeni istek bekleme kuyruğuna alınmaz; 429 concurrency_exceeded ile reddedilir. Bir aktif istek tamamlandığında, hata verdiğinde veya bağlantı kapandığında kapasite serbest bırakılır. İstemcinizde paralel çağrı sayısını ortak hesap sınırının altında tutun.

Eşzamanlılık limiti saniyede istek sayısıyla aynı mı?

Hayır. Eşzamanlılık, açık istek sayısını; RPS/RPM ise bir zaman aralığındaki çağrı sayısını ölçer. Uzun görevler kapasiteyi daha uzun tutar. Ulaşılabilecek hız model, bağlam, çıktı uzunluğu, ağ ve güvenlik kontrollerine bağlıdır; her model için sabit bir saniyelik hız garantisi yoktur.

Streaming yanıtı nasıl kullanırım?

Desteklenen istekte stream: true gönderin ve SSE olaylarını tamamlanma olayına kadar okuyun. Sağlayıcıdan doğrulanmış metin veya araç parçaları geldikçe aktarılır. keepalive/ping bağlantıyı canlı tutar; cevap metni veya kullanım tokenı değildir. İstemci, proxy veya arayüzünüz bütün cevabı tamponluyorsa parçalar sonradan toplu görünebilir.

Model düşünürken neden henüz cevap metni gelmez?

Derin reasoning görevinde model, görünür cevaptan önce düşünme işlemi yapabilir. Ham düşünme tokenları normal cevap metni değildir; Chat biçiminde bunların tamamı gösterilmez. İlk metin ve toplam tamamlanma süreleri farklıdır. İstemcide uzun görevler için uygun zaman aşımı kullanın ve bağlantı canlılığını gerçek tamamlanmayla karıştırmayın.

Akış koparsa otomatik retry nasıl davranır?

Çıktı başlamadan oluşan uygun geçici bağlantı hatalarında sistem güvenli yeniden deneme yapabilir. Metin veya araç çıktısı teslim edilmeye başladıktan sonra yeni bir üretim eski yanıta eklenmez; kopma açık hata olarak sonlandırılır. İstemci terminal olayı gelmeyen cevabı başarılı saymamalı, parçalı araç çağrısını çalıştırmamalıdır.

Kategori 04

Görsel üretimi ve düzenleme

Image 2/2.5, Flare, Sunburst, çıktı biçimleri ve görsel kotası.

Hangi görsel model kimlikleri kullanılabilir?

Katalogda gpt-image-2, gpt-image-2.5, gpt-image-2.5-flare ve gpt-image-2.5-sunburst bulunur. Flare ve Sunburst kimlikleri ilgili moda doğrudan erişim sağlar; Image 2.5 isteğinde desteklenen mode/quality seçeneği de kullanılabilir. Paketinizde görsel erişiminin ve kalan görsel kotasının olması gerekir.

Görsel üretimi hangi kotadan düşer?

Paket modunda görsel çağrıları ayrı görsel kotasıyla değerlendirilir; metin istek sayısıyla aynı havuz değildir. Kota miktarı ve günlük/haftalık/aylık yenilenme periyodu pakete göre değişir. Bakiye modunda ise görsel modeli için yayımlanmış ücret uygulanır. Güncel hakkınızı Paketler ve paneldeki Kota Havuzları bölümünden kontrol edin.

Üretim, düzenleme ve variation uç noktaları hangileridir?

Yeni görsel için /v1/images/generations, mevcut görsel üzerinde değişiklik için /v1/images/edits, varyasyon için /v1/images/variations kullanılır. Düzenleme isteğinde dosya ve gerekiyorsa maske gönderilir; istemciye göre multipart biçimi gerekebilir. Modelin desteklediği parametreleri API Referansı’ndaki örneklerle eşleştirin.

Görseller URL mi yoksa Base64 mü döner?

Desteklenen istekte response_format: "url" veya "b64_json" seçebilirsiniz. URL’ler süreli olabilir; kalıcı kullanacağınız görseli kendi depolamanıza alın. Çözünürlük, kalite, dosya formatı ve transparan arka plan desteği seçilen model ve uç noktanın parametrelerine bağlıdır; geçersiz kombinasyonlar reddedilir.

Kategori 05

API, Codex ve araç entegrasyonları

OpenAI/Anthropic biçimleri, SDK’lar, IDE’ler ve tool çağrıları.

OpenAI uyumlu API için base URL nedir?

Base URL https://api.vangu.dev/v1 olmalıdır. Chat için /v1/chat/completions, native Responses için /v1/responses kullanılır. Python’da OpenAI(base_url="https://api.vangu.dev/v1", api_key="VANGU_API_KEY"), Node.js’te new OpenAI({baseURL:"https://api.vangu.dev/v1",apiKey:"VANGU_API_KEY"}) yapısını kendi anahtarınızla kullanın. Model kimliğini de ayrıca seçin.

Codex uygulaması veya CLI nasıl bağlanır?

Dokümantasyonun Codex bölümündeki işletim sisteminize uygun hızlı kurulum veya masaüstü kurulum aracını kullanın. Sağlayıcı base URL’si https://api.vangu.dev/v1, wire API biçimi responses olmalıdır. Panel anahtarınızı ve erişiminiz olan modeli seçin; örneğin gpt-6.1-sol. Eski terminal veya uygulama oturumunun yeni ayarı alması için yeniden açılması gerekebilir.

Anthropic biçimi ve Claude Code nasıl kullanılır?

Anthropic uyumlu base URL https://api.vangu.dev/anthropic, mesaj uç noktası /anthropic/v1/messages biçimindedir. Claude Code için dokümantasyondaki kurulum adımlarını ve Vangu anahtarını kullanın; default, büyük ve küçük görev model ayarlarını eriştiğiniz Vangu model kimliklerine eşleyin. Protokol uyumluluğu, Claude modellerinin paketinizde bulunduğu anlamına gelmez.

Tool/function çağrılarında komutu kim çalıştırır?

Müşteri tarafından tanımlanan function/tool çağrılarında model araç adı ve argümanları üretir; komutu veya fonksiyonu sizin uygulamanız çalıştırıp sonucu geri gönderir. Araç tanımını, çağrı kimliğini ve sonuç eşleşmesini koruyun. Sunucu, istemci aracındaki shell komutunu sizin bilgisayarınızda kendiliğinden çalıştırmaz.

Araç kullanan ajanlar bir isteği nasıl tamamlar?

Model araç çağrısı verdiğinde istemci sonucu aynı call ID ile sonraki isteğe ekler. Görev gerekiyorsa birden fazla tur devam eder; her API turu kendi kota/bakiye kurallarına göre değerlendirilir. Uygulamanız maksimum tur, süre, kullanıcı iptali ve araç izinlerini yönetmelidir. Yarım kalan JSON argümanlarını başarılı çağrı gibi çalıştırmayın.

Cache ve araç çıktısı küçültme ne işe yarar?

Provider prompt cache, tekrar kullanılan aynı bağlam başlangıcını işlerken bazı giriş tokenlarını cached olarak raporlayabilir; özgün cevapların aynılaşması anlamına gelmez. Desteklenen komut sonuçlarında API tarafındaki araç çıktısı küçültme gereksiz hacmi azaltabilir; ek müşteri kurulumu gerektirmez. Her metin veya araç sonucu küçültülmez ve sabit bir kota tasarrufu garantisi verilmez.

Kategori 06

Ödemeler ve kullandıkça öde

USD tarifesi, TL kuru, bakiye, kart ve manuel tahsilatlar.

Paket ve bakiye modları nasıl ayrılır?

API anahtarını oluştururken Paket Kotası veya Bakiye: Kullandıkça Öde modunu seçersiniz. Paket anahtarı aktif paket haklarını; bakiye anahtarı cüzdanı kullanır. Paket kotası dolunca bütün istekler kendiliğinden bakiyeye geçmez. İlgili anahtarın ücretlendirme modunu panelden açıkça yönetebilirsiniz.

Kullandıkça öde fiyatı nasıl hesaplanır?

Metin modellerinde giriş, cached giriş ve çıktı için milyon token başına USD tarifeleri ayrıdır. Reasoning sağlayıcının çıktı toplamına dahildir. TL hesabında kayıtlı USD tarifesi güncel otomatik alınan USD/TRY kuruyla çevrilir. Görsel modellerinde modelin görsel tarifesi uygulanır. Güncel fiyatı Paketler/API fiyatları bölümünden kontrol edin; paket istek çarpanı bu tarifenin yerine geçmez.

Kart, kripto, nakit ve banka havalesi ödemeleri nasıl görünür?

Kart ödemeleri Stripe üzerinden işlenir. Kripto, nakit veya banka havalesiyle yapılan dış tahsilatlar yönetici tarafından kayıt altına alınabilir; müşteri Ödemeler sayfasında gerçek yöntem ayrı gösterilir. Ödeme kaydıyla birlikte paket tanımlanması seçilmişse erişim de tanımlanır; yalnız tahsilat kaydı girilmesi tek başına yeni paket hakkı vermez.

Cüzdandan paket almak yeni bir kart tahsilatı mı?

Hayır. Bakiye yükleme ve bakiyeyle paket satın alma farklı işlemlerdir. Bakiye daha önce kartla yüklense bile sonraki paket alımının yöntemi Cüzdan olarak görünür. Paket bedeli cüzdandan düşer; aynı tutarın tekrar kartınızdan tahsil edilmesi gerekmez.

Ödeme yaptım ama paketim görünmüyorsa ne yapmalıyım?

Ödemeler sayfasından siparişin durumunu ve detayını kontrol edin. Kart doğrulaması veya ödeme kontrolü sürüyorsa aynı siparişin işlemini tamamlayın; ikinci bir ödeme oluşturmayın. Manuel tahsilatta paket tanımlama seçeneğinin de işlenmiş olması gerekir. Sorun devam ederse sipariş numarası ve ödeme zamanı ile destek talebi açın.

Kategori 07

Hesap, güvenlik ve müşteri paneli

Anahtar güvenliği, sohbet, destek ve referans sistemi.

API anahtarımı ve hesabımı nasıl koruyabilirim?

Üretim ve test için ayrı anahtar kullanın. Anahtarı tarayıcıda herkese açık kodun içine, kaynak deposuna veya destek mesajına koymayın. Panelden kapsam/model/IP kısıtlarını ve son geçerliliği belirleyebilir; anahtarı yenileyebilir veya iptal edebilirsiniz. Hesap güvenliğinde TOTP/2FA kullanın ve kurtarma kodlarını güvenli saklayın.

İstek ve yanıtlarım saklanıyor veya eğitimde kullanılıyor mu?

Vangu istem ve yanıtlarınızı model eğitimi için kullanmaz. İstekler hizmet için seçilen sağlayıcıya iletilir ve sağlayıcının veri işleme koşulları da geçerlidir. İçerik saklama etkinse sohbet geçmişi şifreli ve süreli tutulur. Teknik kullanım, cache ve tekrar yanıtı kayıtları ayrı saklama kurallarına tabidir; güncel ayrıntılar Gizlilik sayfasındadır.

Chat sayfası ve API aynı paket haklarını mı kullanır?

chat.vangu.dev hesabınıza bağlı sohbet arayüzüdür. Model erişimi, paket kotaları ve tanımlı token bütçeleri hesabınızın kurallarına göre uygulanır. Mesajlaşma, dosya/görsel ve desteklenen araç iş akışları seçilen model ve aktif haklara bağlıdır. Chat içinden müşteri paneline dönebilirsiniz.

Referans sistemi nasıl çalışır?

Müşteri panelindeki Referans Sistemi bölümünden size özel bağlantıyı paylaşabilirsiniz. Bu bağlantıyla kayıt olup size bağlanan müşteriler panelde görünür. Uygun başarılı dış ödemelerde hesabınıza tanımlı oran kadar komisyon bakiyeye yansır; varsayılan oran %5’tir ve hesabınıza özel değişebilir. Cüzdan içi harcama yeni dış tahsilat sayılmaz; iadeler ve ödeme geri dönüşleri komisyonu düzeltebilir.

Kategori 08

Hatalar, loglar ve destek

401/403/429, akış kopmaları, ödeme kontrolleri ve destek için gerekli bilgiler.

401 veya 403 hatası alıyorsam neyi kontrol etmeliyim?

401 için doğru Vangu anahtarını gönderdiğinizi, başında/sonunda boşluk olmadığını, iptal edilmediğini ve uygulamanın eski anahtarı kullanmadığını kontrol edin. 403 için uç nokta kapsamı, model/IP izinleri ve hesap durumuna bakın. Anahtarı destek mesajında paylaşmadan hata kodunu ve request ID’yi iletin.

429 her zaman aynı sorun mu demektir?

Hayır. concurrency_exceeded açık istek kapasitesinin dolduğunu; insufficient_quota paket, kullanım hakkı veya bakiye sınırını belirtir. Paket süresi, kalan günlük/token/görsel hakları ve anahtar alt limitlerini kontrol edin. Kota bitişinde aralıksız tekrar denemek çözüm değildir; ilgili hakkın yenilenmesi veya geçerli yeni hak gerekir.

502/503/504 veya “stream disconnected” için ne yapmalıyım?

Bu hatalar sağlayıcı bağlantısı, geçici yoğunluk, tamamlanmamış yanıt veya zaman sınırıyla ilişkili olabilir. Hata kodu, zaman ve request ID ile logu eşleştirin. Çıktı başlamadan güvenli geçici hata retry edilebilir; başlamış yanıtta yeniden üretim ayrı istek olarak değerlendirilmelidir. İstemci/proxy zaman aşımı ve streaming desteğini de kontrol edin.

Loglarda token kullanımı ve cache oranı nasıl okunur?

Giriş tokenı bağlamı, çıktı tokenı cevap ve sağlayıcının çıktı içine dahil ettiği reasoning kullanımını gösterir. Cached tokenlar girişin alt kümesidir; giriş toplamına ikinci kez eklenmez. Cache oranı cached giriş / toplam giriştir. Tahmini veya başarısız ölçümleri gerçek provider kullanımından ayırın; yüksek cache oranı tek başına sabit bir abonelik kotası tasarrufu anlamına gelmez.

Destek talebi açarken hangi bilgileri göndermeliyim?

Müşteri panelindeki Destek bölümüne model kimliği, uç nokta, yaklaşık Türkiye saati, request ID veya varsa cf-ray, hata kodu ve tekrarlama adımlarını ekleyin. Kod paylaşacaksanız API anahtarı, parola ve kişisel verileri çıkarın. Ödeme sorunu için sipariş numarasını da ekleyin.