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.
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ık | Değer | Zorunlu | Açıklama |
|---|---|---|---|
| Authorization | Bearer <API_KEY> | Evet | Vangu geliştirici anahtarınız (`vgu_live_...`) |
| Content-Type | application/json | Evet | JSON veri gövdesi |
Gövde Parametreleri (Body Parameters)
| Parametre | Tip | Zorunlu | Açıklama |
|---|---|---|---|
| model | string | Evet | Kullanı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) |
| messages | array | Evet | Rol (`system`, `user`, `assistant`) ve içerik (`content`) nesneleri dizisi |
| temperature | number | Hayır (0.7) | Örnekleme rastlantısallığı (0.0 kesin - 2.0 yaratıcı arası) |
| max_tokens | integer | Hayır | Üretilecek maksimum token üst tavanı |
| stream | boolean | Hayır (false) | Server-Sent Events (SSE) ile anlık token akışı |
| response_format | object | Hayır | `{"type": "json_object"}` ile yapılandırılmış JSON çıktısı zorunluluğu |
| tools | array | Hayır | Modelin çağırabileceği fonksiyon şemaları (Function calling) |
Örnek İstek ve Yanıt
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
}'
{
"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:
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]
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ık | Değer | Zorunlu | Açıklama |
|---|---|---|---|
| x-api-key | <API_KEY> | Evet | Vangu geliştirici tokeni (`vgu_live_...`) |
| anthropic-version | 2023-06-01 | Evet | Anthropic protokol sürümü |
| Content-Type | application/json | Evet | JSON veri gövdesi |
Gövde Parametreleri
| Parametre | Tip | Zorunlu | Açıklama |
|---|---|---|---|
| model | string | Evet | Model kimliği: `gpt-5.6-sol` (gelişmiş kodlama) veya `gpt-6-astra` (amiral gemisi) |
| messages | array | Evet | Kullanıcı ve asistan mesaj geçmişi dizisi |
| max_tokens | integer | Evet | Üretilecek maksimum token tavanı (Anthropic protokolünde zorunludur) |
| system | string | Hayır | Sistem davranış talimatı ve rol tanımı |
| temperature | number | Hayır | Örnekleme çeşitliliği (0.0 - 1.0) |
| stream | boolean | Hayır (false) | Anthropic SSE olay akışı |
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."}
]
}'
{
"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
}
}
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.
| Parametre | Tip | Zorunlu | Açıklama |
|---|---|---|---|
| model | string | Evet | Kod modeli kimliği: `gpt-5.6-sol` veya `gpt-5.6-terra` |
| prompt | string | Evet | Tamamlanacak kod öneki veya başlangıç fonksiyonu |
| suffix | string | Hayır | FIM tamamlamalarında imleçten sonraki kod parçası |
| max_tokens | integer | Hayır (256) | Üretilecek maksimum kod token sayısı |
| stop | array | Hayır | Tamamlamayı durduracak karakter dizileri (örn. \`["\\n}"]\`) |
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}"]
}'
{
"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"
}
]
}
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.
| Parametre | Tip | Zorunlu | Açıklama |
|---|---|---|---|
| model | string | Evet | `gpt-image-2` (hızlı/standart) veya `gpt-image-2.5` (ultra gerçekçi) |
| prompt | string | Evet | Üretilmek istenen görselin detaylı açıklaması |
| n | integer | Hayır (1) | Üretilecek görsel adedi (1 ile 4 arası) |
| size | string | Hayır (1024x1024) | Görsel boyutu: `1024x1024`, `1536x1024`, `1024x1536` |
| quality | string | Hayır (standard) | `standard` veya `hd` detay seviyesi |
| response_format | string | Hayır (url) | `url` (geçici güvenli indirme linki) veya `b64_json` (Base64) |
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
}'
{
"created": 1788796800,
"data": [
{
"url": "https://assets.vangu.dev/generated/img_89a7f3e1b2c4.png",
"revised_prompt": "Minimalist cloud data center, cinematic blue lighting, hyperrealistic architectural photography"
}
]
}
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ği | Kategori & Amaç | Fiyat Çarpanı | Ort. Gecikme | Hiyerarşi Seviyesi |
|---|---|---|---|---|
| gpt-5.6-luna | Ultra Hızlı Sınıflandırma, Filtreleme, Özetleme | 1.0x | < 100 ms | En Ekonomik & Hızlı (En Ucuz) |
| gpt-5.6-terra | Genel Amaçlı Metin, Asistan & Günlük Kodlama | 1.0x | < 180 ms | Standart / Genel |
| gpt-5.6-sol | Derin Akıl Yürütme, Mimari Kodlama & Refactoring | 1.2x | < 300 ms | Gelişmiş / Yüksek (Pahalı) |
| gpt-6-astra | Apex Amiral Gemisi Model, Karmaşık Analiz | 2.0x | < 650 ms | En Üst Model (En Pahalı) |
| gpt-image-2 | Standart Hızlı Görsel Üretimi | Dahil (100/Hafta) | ~ 2.5 sn | Görsel Modeli |
| gpt-image-2.5 | Ultra Gerçekçi Sinematik Görsel Üretimi | Dahil (100/Hafta) | ~ 4.0 sn | Ultra Görsel Modeli |
curl https://api.vangu.dev/v1/models \
-H "Authorization: Bearer vgu_live_sample_token_67b8a901"
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)
{
"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ğer | Açıklama |
|---|---|---|
| X-Vangu-Plan | daily-pro | Aktif paket kimliği |
| X-RateLimit-Limit | 20000 | Paketin toplam günlük veya süreli çağrı hakkı |
| X-RateLimit-Remaining | 18450 | Kalan kullanılabilir istek sayısı |
| X-RateLimit-Reset | 1788825600 | Kota yenilenme anı (Gece 00.00 UTC+3 Unix epoch zamanı) |
| X-Concurrency-Limit | 10 | Aynı anda izin verilen eşzamanlı istek tavanı |
| X-Concurrency-Current | 2 | Şu anda işlenen aktif eşzamanlı istek adedi |