VANGU / GELİŞTİRİCİ

Uç Noktalar ve Parametre Referansı

REST mimarisi üzerine kurulu OpenAI, Anthropic, Codex ve Resim üretim uç noktalarının girdi, çıktı, SSE streaming ve durum kodları belgeleri.

POST /v1/chat/completions POST /anthropic/v1/messages POST /codex/v1/completions POST /v1/images/generations GET /v1/models HTTP Hata & Telemetri
POST https://api.vangu.dev/v1/chat/completions

1. OpenAI Tipi Chat Completions

OpenAI standart şemasında metin tamamlama, diyalog akışı ve asistan yanıtı üretir. OpenAI Python / Node SDK, LangChain, LiteLLM, Aider ve Cursor ile %100 uyumludur.

İstek Başlıkları (Headers)

BaşlıkDeğerZorunluAçıklama
AuthorizationBearer <API_KEY>EvetVangu geliştirici anahtarınız (`vgu_live_...`)
Content-Typeapplication/jsonEvetJSON veri gövdesi

Gövde Parametreleri (Body Parameters)

ParametreTipZorunluAçıklama
modelstringEvetKullanılacak model: `gpt-5.6-luna` (en ucuz/hızlı), `gpt-5.6-terra` (genel), `gpt-5.6-sol` (gelişmiş kodlama), `gpt-6-astra` (amiral gemisi)
messagesarrayEvetRol (`system`, `user`, `assistant`) ve içerik (`content`) nesneleri dizisi
temperaturenumberHayır (0.7)Örnekleme rastlantısallığı (0.0 kesin - 2.0 yaratıcı arası)
max_tokensintegerHayırÜretilecek maksimum token üst tavanı
streambooleanHayır (false)Server-Sent Events (SSE) ile anlık token akışı
response_formatobjectHayır`{"type": "json_object"}` ile yapılandırılmış JSON çıktısı zorunluluğu
toolsarrayHayırModelin çağırabileceği fonksiyon şemaları (Function calling)

Örnek İstek ve Yanıt

BASH / cURL
curl https://api.vangu.dev/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer vgu_live_sample_token_67b8a901" \
  -d '{
    "model": "gpt-5.6-terra",
    "messages": [
      {"role": "system", "content": "Sen Vangu altyapı asistanısın."},
      {"role": "user", "content": "Paket kotam ne zaman yenilenir?"}
    ],
    "temperature": 0.5
  }'

JSON Response
{
  "id": "chatcmpl_98a76f21bc",
  "object": "chat.completion",
  "created": 1788796800,
  "model": "gpt-5.6-terra",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Günlük paketinizin istek kotası her gece saat tam 00.00'da sıfırlanarak yenilenir."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 19,
    "completion_tokens": 22,
    "total_tokens": 41
  }
}

SSE Canlı Akış (Streaming) Formatı

<code>"stream": true</code> parametresi ile istek atıldığında sunucu yanıtı aşağıdaki SSE parçacıkları halinde anlık iletir:

Server-Sent Events (SSE)
data: {"id":"chatcmpl_98a76","choices":[{"delta":{"role":"assistant","content":"Günlük"}}]}
data: {"id":"chatcmpl_98a76","choices":[{"delta":{"content":" paketinizin"}}]}
data: {"id":"chatcmpl_98a76","choices":[{"delta":{"content":" kotası..."}}]}
data: [DONE]

POST https://api.vangu.dev/anthropic/v1/messages

2. Anthropic Tipi Messages API (Claude Code Uyumlu)

Anthropic SDK ve resmi Claude Code CLI aracıyla tam uyumlu Messages formatı. Sistem komutları üst düzey <code>system</code> parametresinde, konuşma geçmişi ise <code>messages</code> dizisinde iletilir.

Anthropic İstek Başlıkları (Headers)

BaşlıkDeğerZorunluAçıklama
x-api-key<API_KEY>EvetVangu geliştirici tokeni (`vgu_live_...`)
anthropic-version2023-06-01EvetAnthropic protokol sürümü
Content-Typeapplication/jsonEvetJSON veri gövdesi

Gövde Parametreleri

ParametreTipZorunluAçıklama
modelstringEvetModel kimliği: `gpt-5.6-sol` (gelişmiş kodlama) veya `gpt-6-astra` (amiral gemisi)
messagesarrayEvetKullanıcı ve asistan mesaj geçmişi dizisi
max_tokensintegerEvetÜretilecek maksimum token tavanı (Anthropic protokolünde zorunludur)
systemstringHayırSistem davranış talimatı ve rol tanımı
temperaturenumberHayırÖrnekleme çeşitliliği (0.0 - 1.0)
streambooleanHayır (false)Anthropic SSE olay akışı
BASH / cURL
curl https://api.vangu.dev/anthropic/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: vgu_live_sample_token_67b8a901" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "gpt-5.6-sol",
    "max_tokens": 1024,
    "system": "Sen kıdemli bir TypeScript yazılım mimarısın.",
    "messages": [
      {"role": "user", "content": "Event loop ve Worker thread farkını özetle."}
    ]
  }'

JSON Anthropic Response
{
  "id": "msg_01XyZ987654321",
  "type": "message",
  "role": "assistant",
  "model": "gpt-5.6-sol",
  "content": [
    {
      "type": "text",
      "text": "Event Loop tek iş parçacığı üzerinde I/O operasyonlarını asenkron yönetirken, Worker Thread\'ler CPU yoğun hesaplamaları ayrı işletim sistemi iş parçacıklarına dağıtır."
    }
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 28,
    "output_tokens": 36
  }
}

POST https://api.vangu.dev/codex/v1/completions

3. Codex Tipi Kod Tamamlama API

IDE eklentileri, Cursor, Aider ve inline kod tamamlama sistemleri için optimize edilmiş düşük gecikmeli ham metin tamamlama uç noktası. FIM (Fill-In-the-Middle) desteğiyle kodun ortasındaki boşlukları doldurabilir.

ParametreTipZorunluAçıklama
modelstringEvetKod modeli kimliği: `gpt-5.6-sol` veya `gpt-5.6-terra`
promptstringEvetTamamlanacak kod öneki veya başlangıç fonksiyonu
suffixstringHayırFIM tamamlamalarında imleçten sonraki kod parçası
max_tokensintegerHayır (256)Üretilecek maksimum kod token sayısı
stoparrayHayırTamamlamayı durduracak karakter dizileri (örn. \`["\\n}"]\`)
BASH / cURL
curl https://api.vangu.dev/codex/v1/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer vgu_live_sample_token_67b8a901" \
  -d '{
    "model": "gpt-5.6-sol",
    "prompt": "function verifyHmacSignature(secret: string, payload: string, signature: string): boolean {\n",
    "max_tokens": 128,
    "temperature": 0.1,
    "stop": ["\n}"]
  }'

JSON Codex Response
{
  "id": "cmpl_78a1b2c3d4",
  "object": "text_completion",
  "created": 1788796800,
  "model": "gpt-5.6-sol",
  "choices": [
    {
      "text": "  const expected = crypto.createHmac(\'sha256\', secret).update(payload).digest(\'hex\');\n  return crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected));",
      "index": 0,
      "finish_reason": "stop"
    }
  ]
}

POST https://api.vangu.dev/v1/images/generations

4. Resim Üretim API (gpt-image-2 & 2.5)

Metin açıklamalarından yüksek çözünürlüklü görsel üretir. Sınırsız paket sahipleri için <strong>haftalık 100 resim oluşturma hakkı</strong> dahildir.

ParametreTipZorunluAçıklama
modelstringEvet`gpt-image-2` (hızlı/standart) veya `gpt-image-2.5` (ultra gerçekçi)
promptstringEvetÜretilmek istenen görselin detaylı açıklaması
nintegerHayır (1)Üretilecek görsel adedi (1 ile 4 arası)
sizestringHayır (1024x1024)Görsel boyutu: `1024x1024`, `1536x1024`, `1024x1536`
qualitystringHayır (standard)`standard` veya `hd` detay seviyesi
response_formatstringHayır (url)`url` (geçici güvenli indirme linki) veya `b64_json` (Base64)
BASH / cURL
curl https://api.vangu.dev/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer vgu_live_sample_token_67b8a901" \
  -d '{
    "model": "gpt-image-2.5",
    "prompt": "Modern bir bulut bilişim veri merkezi, mavi neon aydınlatmalar, minimalist ve sinematik 8k render",
    "size": "1024x1024",
    "quality": "hd",
    "n": 1
  }'

JSON Response
{
  "created": 1788796800,
  "data": [
    {
      "url": "https://assets.vangu.dev/generated/img_89a7f3e1b2c4.png",
      "revised_prompt": "Minimalist cloud data center, cinematic blue lighting, hyperrealistic architectural photography"
    }
  ]
}

GET https://api.vangu.dev/v1/models

5. Model Kataloğu ve Çarpanlar

API anahtarınızla çağırabileceğiniz güncel modeller, fiyat hiyerarşisi ve yanıt gecikmesi metrikleri:

Model KimliğiKategori & AmaçFiyat ÇarpanıOrt. GecikmeHiyerarşi Seviyesi
gpt-5.6-lunaUltra Hızlı Sınıflandırma, Filtreleme, Özetleme1.0x< 100 msEn Ekonomik & Hızlı (En Ucuz)
gpt-5.6-terraGenel Amaçlı Metin, Asistan & Günlük Kodlama1.0x< 180 msStandart / Genel
gpt-5.6-solDerin Akıl Yürütme, Mimari Kodlama & Refactoring1.2x< 300 msGelişmiş / Yüksek (Pahalı)
gpt-6-astraApex Amiral Gemisi Model, Karmaşık Analiz2.0x< 650 msEn Üst Model (En Pahalı)
gpt-image-2Standart Hızlı Görsel ÜretimiDahil (100/Hafta)~ 2.5 snGörsel Modeli
gpt-image-2.5Ultra Gerçekçi Sinematik Görsel ÜretimiDahil (100/Hafta)~ 4.0 snUltra Görsel Modeli
BASH / cURL
curl https://api.vangu.dev/v1/models \
  -H "Authorization: Bearer vgu_live_sample_token_67b8a901"

HTTP Hata Şemaları & Telemetri Başlıkları

6. Hata Yanıtları ve Telemetri Başlıkları

Vangu platformu hata durumlarında kesin JSON gövdeleri döndürür. Günlük paketlerde kota aşıldığında (429) kotanız her gece saat 00.00’da otomatik sıfırlanır.

OpenAI Tipi Hata Yanıtı (429 Too Many Requests)

JSON 429 Error
{
  "error": {
    "message": "Günlük paket kotanız doldu. Kota her gece 00.00'da sıfırlanır.",
    "type": "insufficient_quota",
    "code": "daily_quota_exceeded",
    "reset_timestamp": 1788825600
  }
}

Her Yanıtta Dönen Telemetri Başlıkları

BaşlıkÖrnek DeğerAçıklama
X-Vangu-Plandaily-proAktif paket kimliği
X-RateLimit-Limit20000Paketin toplam günlük veya süreli çağrı hakkı
X-RateLimit-Remaining18450Kalan kullanılabilir istek sayısı
X-RateLimit-Reset1788825600Kota yenilenme anı (Gece 00.00 UTC+3 Unix epoch zamanı)
X-Concurrency-Limit10Aynı anda izin verilen eşzamanlı istek tavanı
X-Concurrency-Current2Şu anda işlenen aktif eşzamanlı istek adedi