GPT-5.6 API Nasıl Kullanılır: Sol, Terra ve Luna

OpenAI, GPT-5.6'yı 9 Temmuz 2026'da genel kullanıma sundu ve API erişimi kendi kendine sağlanıyor: herhangi bir API hesabı bugün bekleme listesi veya plan kısıtlaması olmaksızın çağırabilir. Temmuz başından itibaren devam eden sınırlı önizleme artık geride kaldı. Geliştiriciler için değişen şey, lansmanın kendisinin şekli oldu. Tek bir model yerine üç tane alıyorsunuz: Sol, Terra ve Luna; her biri kendi fiyat noktasına, altı akıl yürütme çabası seviyesine ve açık bilgi istemi önbellekleme kontrollerine sahip.

Bu, tipik bir model değişiminden daha fazla karar gerektiriyor ve ilk hafta seçtiğiniz varsayılanlar kalıcı olma eğilimindedir. Bu kılavuz, model kimliklerini ve her birinin ne zaman kullanılması gerektiğini, Python ve curl'daki ilk isteğinizi, akıl yürütme çabasını, önbellek kurulumunu, yeni Yanıtlar API yüzeyini ve GPT-5.5'ten sürprizler olmadan nasıl geçiş yapacağınızı anlatıyor. Önce amiral gemisi katmanı hakkında tam bilgi edinmek isterseniz, GPT-5.6 Sol genel bakışı konumlandırma ve karşılaştırmaları kapsar; bu yazı pratik bilgiler sunmaktadır.

Sonunda, her üç katmana da çalışan çağrılara ve Apidog'da kendi bilgi istemleriniz üzerinde bunları karşılaştırmanın tekrarlanabilir bir yoluna sahip olacaksınız, böylece maliyet ve kalite kararları lansman gönderisinden ziyade kendi verilerinizden gelecektir.

TL;DR

Üç model kimliği, tek nesil: gpt-5.6-sol (en derin akıl yürütme), gpt-5.6-terra (dengeli), gpt-5.6-luna (en hızlı ve en ucuz). `gpt-5.6` takma adı doğrudan Sol'a yönlendirilir.
Herhangi bir OpenAI API hesabı için API erişimi kendi kendine sağlanır. Hiçbir kısıtlama kalmamıştır.
1M jeton başına fiyatlandırma: Sol $5 giriş / $30 çıkış, Terra $2.50 / $15, Luna $1 / $6.
Akıl yürütme çabası, none'dan max'a kadar altı seviyeye sahiptir. Pro modu, ayrı bir model değil, her üç modelde de bir ayardır (reasoning.mode: "pro").
Açık bilgi istemi önbellekleme geldi: `prompt_cache_options.mode: "explicit"` artı bir `ttl`. Yazma işlemleri 1.25 kat faturalandırılır, okuma işlemleri %90 indirimi korur ve önbellekler en az 30 dakika boyunca aktif kalır.
GPT-5.5'ten geçiş bir ayarlama aşamasıdır: bir çaba seviyesi düşüğünü test edin ve bilgi istemlerinizden kısalık yönergelerini çıkarın.

Üç model kimliği ve her birini ne zaman seçeceğiniz

GPT-5.6, OpenAI'ın alışılagelmiş adlandırma biçimini bozuyor. Sayı nesli ifade eder; Sol, Terra ve Luna, MarkTechPost'un lansman haberinde belirtildiği gibi, kendi hızlarında ilerleyecek dayanıklı yetenek katmanlarıdır. Bugün standartlaştırdığınız katman, gelecek nesilde de anlamını korur.

Model Kimliği	Katman	1M jeton başına giriş / çıkış	Şu durumlarda tercih edin
`gpt-5.6-sol`	Amiral Gemisi	$5 / $30	Derin akıl yürütme, ajan orkestrasyonu, zor hata ayıklama
`gpt-5.6-terra`	Dengeli	$2.50 / $15	Günlük ürün özellikleri, daha düşük maliyetle GPT-5.5 sınıfı işler
`gpt-5.6-luna`	Hızlı	$1 / $6	Sınıflandırma, çıkarma, yönlendirme, ilk taslak hazırlama

Sol amiral gemisidir. OpenAI, onu Ajanların Son Sınavı'nda GPT-5.5 için 46.9'a karşılık yaklaşık 53 olarak rapor ediyor, bu nedenle bunu bir lansman günü iddiası olarak kabul edin ve kendi görevlerinizde doğrulayın. Terra pragmatik bir seçimdir: OpenAI, onu GPT-5.5 ile yaklaşık yarı maliyetle rekabetçi olarak konumlandırıyor. Luna, derinlikten çok birim ekonomisini önemsediğiniz yüksek hacimli, gecikmeye duyarlı işler için mevcuttur.

Mantıklı bir varsayılan: Terra üzerinde prototip oluşturun, yalnızca Terra'nın ölçülebilir şekilde başarısız olduğu durumlarda Sol'a yükseltin ve bilgi istemi kararlı hale geldiğinde yüksek hacimli yolları Luna'ya indirin. GPT-5.6 fiyatlandırma dökümü, bu oranların nesiller ve rakipler arasında nasıl karşılaştırıldığına dair daha derinlemesine bilgi verir.

Bilmeye değer bir takma ad: Sonek olmayan `gpt-5.6` Sol'a yönlendirilir. Üretim kodunuzda açık katman kimliklerini sabitleyin, böylece her çağrı maliyetinin ne olduğunu tam olarak belirtir.

İlk isteğiniz

Aşağıdaki model kimlikleri, OpenAI'ın geliştirici belgeleriyle kelimesi kelimesine eşleşmektedir. Faturalandırması etkinleştirilmiş bir OpenAI API anahtarına ihtiyacınız var; başka hiçbir şeye değil.

Sohbet Tamamlamaları değişmeden çalışır, bu nedenle mevcut kod yalnızca bir model değişimi gerektirir:

from openai import OpenAI

client = OpenAI()

response = client.chat.completions.create(
    model="gpt-5.6-sol",
    messages=[
        {"role": "system", "content": "You are a concise code reviewer."},
        {"role": "user", "content": "Review this for edge cases: def parse_price(raw): return float(raw.strip('$'))"}
    ]
)

print(response.choices[0].message.content)

Curl'da aynı çağrı:

curl https://api.openai.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [
      {"role": "user", "content": "Explain idempotency keys in one paragraph."}
    ]
  }'

Yeni yapılar için bunun yerine Yanıtlar API'sini hedefleyin. Her genel kullanıma açılan ekleme orada bulunur ve doğrudan bir akıl yürütme bloğu alır:

response = client.responses.create(
    model="gpt-5.6-terra",
    input="Summarize the trade-offs between webhooks and polling.",
    reasoning={"effort": "low"}
)

print(response.output_text)

Başka bir entegrasyon kodu satırı yazmadan önce aynı bilgi istemini her üç katmana karşı çalıştırın. Ton, uzunluk ve gecikme farklarını hissetmek, okumaktan daha kolaydır.

Akıl yürütme çabası seçimi

GPT-5.6, `none`, `low`, `medium`, `high`, `xhigh` ve `max` olmak üzere altı akıl yürütme çabası seviyesi sunar.

none akıl yürütmeyi kapatır. Görev mekanik olduğunda ve gecikme derinlikten daha önemli olduğunda kullanın: yeniden biçimlendirme, açık bir şemaya karşı çıkarma, şablon doldurma. `none`'da Luna, hızlı bir klasik tamamlama modeli gibi davranır ve bu eşleşme, 1 dolarlık giriş oranının parladığı yerdir.

max diğer uçta yer alır. Yanlış bir cevabın yavaş bir cevaptan daha pahalıya mal olduğu sorunlar için saklayın: ince eşzamanlılık hataları, mimari incelemeler, çok adımlı planlama. Daha uzun beklemeler ve daha yüksek bir fatura bekleyin.

Çoğu iş yükü ortada yer alır. `medium` ile başlayın, birer seviye ilerleyin ve yukarı çıkmanın ek maliyetini kabul etmeden önce kaliteyi ölçün. Aşağı inmek genellikle ücretsizdir: OpenAI'ın kendi geçiş rehberliği, birçok GPT-5.5 iş yükünün GPT-5.6'da bir seviye daha düşük kalitede olduğunu belirtir.

Pro modu çabadan ayrıdır. `reasoning.mode: "pro"` olarak ayarlayın ve model, hıza göre yanıt kalitesine öncelik verir. Her üç katmanda da çalışır ve farklı bir model kimliği değil, bir ayardır, bu nedenle aranacak pro'ya özel bir slug yoktur. Hukuki özetler veya olay sonrası incelemeler gibi kalite odaklı iş yükleri onun alanıdır. Tam istek şekli ve kısıtlamaları için OpenAI'ın API referansına bakın.

Bilgi istemi önbelleklemesini ayarlama

GPT-5.6, açık önbellek kontrolü ekler. `prompt_cache_options.mode`'u `"explicit"` olarak ayarlayın ve otomatik önek algılamasına güvenmek yerine neyin önbelleğe alınacağına siz karar verin:

response = client.responses.create(
    model="gpt-5.6-luna",
    input=[
        {"role": "system", "content": SUPPORT_PLAYBOOK},
        {"role": "user", "content": ticket_text}
    ],
    prompt_cache_options={"mode": "explicit"}
)

Aynı seçenekler nesnesindeki bir `ttl` alanı, önbelleğe alınan önekin ne kadar süreyle aktif kalacağını belirler; ne isterseniz isteyin, minimum süre 30 dakikadır. Kabul edilen `ttl` değerleri ve kesme noktası yerleştirme kuralları OpenAI'ın API referansında bulunmaktadır.

Ekonomi basit. Önbellek yazma işlemleri, önbelleğe alınmamış giriş oranının 1.25 katı olarak faturalandırılır. Önbellek okuma işlemleri %90 indirimi korur. Yani önbellekleme ikinci vuruştan itibaren kendini amorti eder: bir önek üzerinde önbelleğe alınmamış iki geçiş, jeton fiyatının 2.0 katına mal olurken, bir yazma artı bir okuma 1.35 katına mal olur.

Uygulamalı bir örnek. Bir destek botunun her Luna çağrısında 40.000 jetonluk bir el kitabı gönderdiğini varsayalım. Önbelleğe alınmamış olarak, bu önek Luna'nın 1M giriş oranı başına 1 dolarlık fiyatıyla çağrı başına 0.04 dolara mal olur. Açık önbellekleme ile ilk çağrı 0.05 dolara yazılır ve `ttl` içindeki her okuma 0.004 dolara mal olur. 100 çağrılık bir yoğunlukta bu, 4.00 dolar yerine 0.45 dolar yapar, bu da faturanızın statik kısmında yaklaşık %89 indirim demektir. 30 dakikalık minimum ömür, yarım saatin altındaki boşluklarla gelen ani trafiğin de ucuz okumalarla karşılaşmaya devam etmesi anlamına gelir.

Genel kural: `ttl` içinde en az iki kez yeniden kullanılan büyük statik bir öneke sahip herhangi bir bilgi istemi, açık modda çalışmalıdır.

Genel Kullanımda Yanıtlar API'sında Yenilikler Neler?

Genel Kullanım ile birlikte üç ekleme geldi, hepsi Yanıtlar API'sında:

Programatik araç çağırma. Modelin bir araç çağrısı yapıp, sonucunuzu bekleyip, ardından bir sonrakini yaptığı gidiş-dönüş dansı yerine, model araçlarınızı düzenleyen JavaScript kodu yazar. Bu kod, ağ erişimi olmayan izole bir V8 çalışma zamanında çalışır, böylece sunucunuzun mesajları ileri geri taşımasına gerek kalmadan döngü yapabilir, dallanabilir ve araç sonuçlarını birleştirebilir.
Çoklu ajan, beta sürümünde. Bir istek, paralel olarak yürütülen alt ajanlara iş dağıtabilir; bu, bir görev bağımsız parçalara ayrıldığında kullanışlıdır.
Kalıcı akıl yürütme. Akıl yürütme bağlamı, `reasoning.context` aracılığıyla dönüşler arasında taşınır, böylece çok turlu bir ajan, her çağrıda düşünce zincirini sıfırdan yeniden oluşturmaz.

Orijinal görüntü boyutlarını koruyan `original` ve `auto` gibi yeni görüntü detay ayarları da bulunmaktadır. Bunların hepsinin istek şekilleri ve parametreleri OpenAI'ın API referansında yer alır; yukarıdaki mekanizmalar etrafında tasarım yapmanız gerekenlerdir.

GPT-5.5'ten Geçiş

OpenAI'ın rehberliği açıktır: geçişi sadece bir model-slug değişikliği olarak değil, bir ayarlama aşaması olarak ele alın. Entegrasyonunuz GPT-5.5 API kılavuzumuzdaki iş akışını takip ediyorsa, üç ayarlama önemlidir.

İlk olarak, mevcut akıl yürütme çabanızı ve bir seviye daha düşüğünü test edin. GPT-5.6 genellikle bir adım aşağıda kaliteyi korur, bu da aynı trafikte doğrudan bir maliyet düşüşüdür.

İkinci olarak, daha kısa yanıtlar bekleyin. GPT-5.6, daha az genel girişle belirgin şekilde daha kısa çıktılar yazar. Bilgi istemlerinizde “öz ol” veya “girişi atla” gibi yönergeler varsa, bunları kaldırın ve yeniden test edin, çünkü birikmiş kısalık yönergeleri artık aşırıya kaçabilir. Simon Willison’ın lansman günü yazısı, ailenin pratikte nasıl davrandığına dair faydalı bağımsız bir okumadır.

Üçüncü olarak, ayarlama yaparken yanıtlarınızdaki önbelleğe alınmış jeton kullanımını izleyin ve üretim trafiğini geçirmeden önce temsili bir görev setini karşılaştırın. Terra'da GPT-5.5'in fiyatının yarısına denk çıktıyı kontrol etmeye değer bir sonuçtur.

Apidog'da API'yi Test Etme

Curl, uç noktanın çalıştığını kanıtlar. Üç katman arasında seçim yapmak tekrarlanabilir bir şeye ihtiyaç duyar. Apidog'u indirin ve küçük bir karşılaştırma düzeneği kurun:

`OPENAI_API_KEY`'inizle birlikte üç değişkenli bir ortam oluşturun: `MODEL_SOL=gpt-5.6-sol`, `MODEL_TERRA=gpt-5.6-terra`, `MODEL_LUNA=gpt-5.6-luna`.
API'ye bir POST isteği oluşturun ve gövdede `{{MODEL_SOL}}`'i referans alın, ardından iki kez kopyalayın ve diğer değişkenleri yerleştirin.
Aynı üretim odaklı bilgi istemini üçüne de gönderin ve yanıtları yan yana okuyun.
Her yanıttaki kullanım bloğunu kontrol edin. Jeton sayılarını her katmanın oranıyla çarparak, başkasının karşılaştırmasına değil, kendi bilgi istemlerinize dayalı bir istek başına maliyet tahmini elde edersiniz.

Aynı düzenek, çaba ayarlaması sırasında değerini korur. Kaydedilmiş bir isteğin çaba seviyesini değiştirin, yeniden gönderin ve çıktı jetonlarının hareketini izleyin; bu sayı, jeton başına oranla çarpıldığında, istek başına görünür hale gelen kalite-maliyet eğrinizdir.

Sıkça Sorulan Sorular

GPT-5.6 API'si herkese açık mı?

Evet. 9 Temmuz 2026'dan beri, herhangi bir OpenAI API hesabı her üç modeli de kendi kendine çağırabilir. Lansman öncesi önizleme kısıtlaması Genel Kullanım'dan önce kaldırıldı ve API erişimi ChatGPT planınıza bağlı değildir. Plan katmanları yalnızca sohbet ürününü şekillendirir; burada Ücretsiz ve Go kullanıcıları Terra'yı alır ve ücretli planlar tam model seçicisini açar.

GPT-5.6'nın bağlam penceresi ve bilgi kesme tarihi nedir?

İlk dokümantasyon kapsamına göre, bu aile 1M jetonluk bir bağlam penceresine, 128K maksimum çıktıya ve 16 Şubat 2026 bilgi kesme tarihine sahiptir. OpenAI'ın model sayfası kayıt kaynağıdır; hesabınız için bunları onaylayana kadar rapor edilen rakamlar olarak kabul edin.

Pro modu ile Ultra arasındaki fark nedir?

Pro modu, her üç modelde de çalışan ve hızı yanıt kalitesiyle takas eden bir API ayarıdır (`reasoning.mode: "pro"`). Ultra, varsayılan olarak dört ajanı paralel çalıştıran çoklu ajan ayarıdır ve Pro ve Kurumsal planlardaki ChatGPT Work'te, ayrıca Plus'tan itibaren Codex'te bulunur. GPT-5.6 ultra mod dökümü, kasıtlı olarak fazladan jeton harcamanın ne zaman değerli olduğunu kapsar.

Sohbet Tamamlamaları mı yoksa Yanıtlar API'si üzerine mi inşa etmeliyim?

Mevcut Sohbet Tamamlamaları kodu, model kimliği değişimiyle çalışmaya devam eder, bu nedenle zorunlu bir yeniden yazma yoktur. Yeni yapılar Yanıtlar API'sini hedeflemelidir: programatik araç çağırma, çoklu ajan ve kalıcı akıl yürütme hepsi orada gönderildi ve OpenAI'ın GPT-5.6 dokümantasyonu buna odaklanıyor.

Bu sizi nereye götürür?

Başlamak için bir geçiş projesine ihtiyacınız yok. Terra'yı seçin, ürününüzden gerçek bir bilgi istemini `medium` çabayla çalıştırın, ardından bir seviye aşağı inin ve karşılaştırın. Bilgi istemleriniz büyük bir statik önek paylaşıyorsa açık önbellekleme bağlayın; yukarıdaki örnekteki %89'luk tasarruf, büyük bir sistem bilgi isteminin sağladığı tipik bir geri dönüşüdür. Ancak o zaman Sol ve Luna'nın yığınınızda nerede olması gerektiğine karar verin.

Üç katmanlı karşılaştırma düzeneğini de elinizin altında bulundurun. Sol, Terra ve Luna kendi hızlarında ilerleyecek, bu nedenle bir sonraki sürüm bir araştırma projesi yerine kaydedilmiş isteklerin yeniden çalıştırılması olacaktır. Apidog bu istekleri, ortamları ve jeton sayılarını tek bir yerde tutar, bu da gelecekteki her model lansmanını bir tahminden ziyade bir öğleden sonra testine dönüştürür.

düğme