Her resmi OpenAI kütüphanesi çalışır; yalnızca base_url değişir. Örnekler gpt-5.6-sol kullanır; Astra paketi için gpt-astra kullan.
Chat Completions
base_url /v1 içermeli ve / ile bitmemeli. Kütüphane /chat/completions’ı kendisi ekler.
Yanıtlar OpenAI şemasını tam olarak takip eder: id chatcmpl-...’dur, usage’da prompt_tokens, completion_tokens ve completion_tokens_details.reasoning_tokens bulunur. Kota tam olarak usage.total_tokens üzerinden ücretlendirilir.
Responses API
Codex ve daha yeni SDK’lar bu protokolü kullanır. Akıl yürütme ayarı reasoning.effort’ta bulunur.
Akıl yürütme gücü
Chat Completions ile reasoning_effort kullan (low, medium, high). Ayarlanmazsa ağ geçidi high kullanır. Basit görevler için token tasarrufu yapmak üzere low ayarla:
reasoning_effort yalnızca Chat Completions içindir. Responses API ile reasoning: {"effort": ...} kullan; /v1/responses’a reasoning_effort göndermek “Unsupported parameter” ile reddedilir.
Akış
Zor sorularda model ilk tokenden önce bir süre düşünebilir. Bağlantının kesilmemesi için stream: true kullan. stream_options.include_usage, son parçanın usage taşımasını sağlar, böylece kotayı kendin uzlaştırabilirsin.
Resim gönderme (görü)
Resimler content dizisine, yerel dosyalar için genel URL veya base64 olarak gider.
Resimler boyuta göre token harcar. Tam 4K ekran görüntüsü göndermek yerine ilgili kısma kırp.
API üzerinden modeller ve kota
subscription, hard_limit_usd’de toplamı döndürür; usage, total_usage’da kullanılanı sent cinsinden döndürür (karşılaştırmadan önce 100’e böl). Kontrol sayfası bunu senin için yapar.