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.

Apidog'u bugün deneyin

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ılavuzda model kimliklerini, her modelin ne zaman kullanılacağını, Python ve curl ile ilk isteği, akıl yürütme çabasını, önbellek kurulumunu, Yanıtlar API'sini ve GPT-5.5'ten geçiş adımlarını uygulamalı olarak ele alacağız. Amiral gemisi katmanı için konumlandırma ve karşılaştırmalar istiyorsanız GPT-5.6 Sol genel bakışı ilgili ayrıntıları kapsar.

Bu yazının sonunda üç katmana da çalışan istekler gönderebilecek ve Apidog ile kendi bilgi istemleriniz üzerinde tekrarlanabilir karşılaştırmalar yapabileceksiniz. Böylece maliyet ve kalite kararlarını lansman duyurusuna değil, kendi verilerinize dayandırabilirsiniz.

TL;DR

• Tek nesil, üç model kimliği:
  • gpt-5.6-sol: en derin akıl yürütme
  • gpt-5.6-terra: dengeli varsayılan
  • gpt-5.6-luna: en hızlı ve en ucuz seçenek
• gpt-5.6 takma adı doğrudan Sol'a yönlendirilir.
• Herhangi bir OpenAI API hesabı API'yi çağırabilir; bekleme listesi veya plan kısıtlaması yoktur.
• 1M jeton başına fiyatlandırma:
  • Sol: $5 giriş / $30 çıkış
  • Terra: $2.50 giriş / $15 çıkış
  • Luna: $1 giriş / $6 çıkış
• Akıl yürütme çabası none ile max arasında altı seviyeye sahiptir.
• Pro modu ayrı bir model değildir; üç modelde de reasoning.mode: "pro" ile etkinleştirilir.
• Açık bilgi istemi önbelleklemesi için prompt_cache_options.mode: "explicit" ve ttl kullanılır.
• GPT-5.5'ten geçerken önce bir seviye daha düşük akıl yürütme çabasını test edin ve artık gereksiz olabilecek kısalık yönergelerini kaldırın.

Üç model kimliği ve her birini ne zaman seçmelisiniz?

GPT-5.6, OpenAI'ın alışılmış model adlandırmasını değiştiriyor. Sayı nesli ifade ederken Sol, Terra ve Luna, MarkTechPost'un lansman haberinde belirtildiği gibi kendi hızlarında ilerleyecek yetenek katmanlarıdır.

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 bu sonucu lansman günü iddiası olarak değerlendirin ve kendi görev setinizde doğrulayın.

Terra, çoğu ürün akışı için pragmatik başlangıç noktasıdır. OpenAI onu GPT-5.5 ile yaklaşık yarı maliyetle rekabetçi olarak konumlandırıyor. Luna ise derinlikten çok birim ekonomisinin ve gecikmenin önemli olduğu yüksek hacimli işler için uygundur.

Pratik varsayılan akış:

1. Terra ile prototip oluşturun.
2. Terra'nın ölçülebilir şekilde başarısız olduğu görevleri Sol'a yükseltin.
3. Bilgi istemi ve çıktı formatı kararlı hale gelen yüksek hacimli yolları Luna'ya taşıyın.

Oranların nesiller ve rakipler arasındaki karşılaştırması için GPT-5.6 fiyatlandırma dökümüne bakabilirsiniz.

Üretimde gpt-5.6 takma adını kullanmak yerine açık katman kimliklerini sabitleyin. Böylece her isteğin maliyet ve kalite profilini koddan doğrudan görebilirsiniz.

İlk isteğinizi gönderin

Aşağıdaki model kimlikleri, OpenAI geliştirici belgeleriyle eşleşir. Faturalandırması etkinleştirilmiş bir OpenAI API anahtarı yeterlidir.

Mevcut Chat Completions kodunu güncelleme

Sohbet Tamamlamaları çalışmaya devam eder. Mevcut entegrasyonda çoğu durumda yalnızca model değerini değiştirmeniz gerekir:

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)

Aynı isteğin curl karşılığı:

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 projelerde Yanıtlar API'sini kullanma

Yeni yapılar için Yanıtlar API'sini hedefleyin. Genel kullanıma açılan yeni yetenekler burada bulunur ve akıl yürütme ayarını doğrudan istek içinde iletebilirsiniz:

from openai import OpenAI

client = OpenAI()

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)

Entegrasyonu genişletmeden önce aynı bilgi istemini Sol, Terra ve Luna ile çalıştırın. Ton, çıktı uzunluğu, gecikme ve maliyet farklarını kendi iş yükünüzde görmek model seçimini hızlandırır.

Akıl yürütme çabasını seçme

GPT-5.6 şu altı akıl yürütme çabası seviyesini sunar:

none → low → medium → high → xhigh → max

Başlangıç için medium kullanın. Ardından aynı değerlendirme seti üzerinde bir seviye aşağı ve yukarı test yapın.

none ne zaman kullanılmalı?

none, akıl yürütmeyi kapatır. Görev mekanikse ve gecikme derinlikten daha önemliyse uygundur:

• Yeniden biçimlendirme
• Açık bir şemaya göre veri çıkarma
• Şablon doldurma
• Basit sınıflandırma
• Yönlendirme

Bu modda Luna, hızlı klasik bir tamamlama modeli gibi davranır. Özellikle yüksek hacimli girişlerde Luna'nın $1 giriş oranı avantaj sağlar.

max ne zaman kullanılmalı?

max, yanlış bir yanıtın yavaş bir yanıttan daha pahalı olduğu görevler için ayrılmalıdır:

• İnce eşzamanlılık hatalarının incelenmesi
• Mimari değerlendirmeler
• Çok adımlı planlama
• Kritik hata ayıklama

Daha uzun gecikme ve daha yüksek fatura bekleyin.

Pro modu

Pro modu, akıl yürütme çabasından ayrı bir ayardır. Her üç modelde de kaliteyi hıza göre önceliklendirmek için kullanılır:

response = client.responses.create(
    model="gpt-5.6-terra",
    input="Analyze the incident report and identify the likely root cause.",
    reasoning={
        "effort": "high",
        "mode": "pro"
    }
)

reasoning.mode: "pro" ayrı bir model kimliği değildir. Hukuki özetler, olay sonrası incelemeler ve kalite öncelikli işler için uygundur. Tam istek şekli ve kısıtlamalar için OpenAI API referansını kontrol edin.

Bilgi istemi önbelleklemesini ayarlama

GPT-5.6 ile açık önbellek kontrolü kullanabilirsiniz. Otomatik önek algılamasına güvenmek yerine, önbelleğe alma davranışını istek üzerinde tanımlayın:

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çenek nesnesindeki ttl alanı, önbelleğe alınmış önekin aktif kalacağı süreyi belirler. Minimum süre 30 dakikadır. Kabul edilen ttl değerleri ve kesme noktası yerleştirme kuralları için OpenAI API referansını kullanın.

Önbellek maliyetini hesaplama

Faturalandırma modeli şöyledir:

• Önbellek yazma: önbelleğe alınmamış giriş fiyatının 1.25 katı
• Önbellek okuma: giriş fiyatında %90 indirim

Bu nedenle önbellekleme ikinci kullanımda avantajlı hale gelir:

• Önbelleksiz iki geçiş: 2.0x
• Bir yazma ve bir okuma: 1.35x

Örnek olarak, destek botunuzun her Luna isteğinde 40.000 jetonluk bir el kitabı gönderdiğini varsayalım:

• Önbelleksiz çağrı başına maliyet: $0.04
• İlk önbellek yazımı: $0.05
• ttl içindeki sonraki her okuma: $0.004

100 çağrılık bir yoğunlukta:

Yöntem	Toplam maliyet
Önbelleksiz	$4.00
Açık önbellekleme	$0.45

Bu, statik önek maliyetinde yaklaşık %89 indirim anlamına gelir.

ttl süresi içinde en az iki kez tekrar kullanılan büyük ve statik bir önekiniz varsa, açık önbellekleme kullanın.

Yanıtlar API'sinde genel kullanıma açılan yenilikler

Genel Kullanım ile birlikte Yanıtlar API'sine üç önemli ekleme geldi:

1. Programatik araç çağırma
   
   Model, araç çağrılarını düzenlemek için JavaScript kodu yazar. Kod, ağ erişimi olmayan izole bir V8 çalışma zamanında yürütülür. Böylece sunucunuz her araç sonucu için mesajları ileri geri taşımadan model döngü, dallanma ve sonuç birleştirme yapabilir.

2. Çoklu ajan — beta
   
   Tek istek, paralel çalışan alt ajanlara görev dağıtabilir. Bu yaklaşımı, işiniz bağımsız parçalara ayrılabiliyorsa kullanın.

3. Kalıcı akıl yürütme
   
   Akıl yürütme bağlamı reasoning.context üzerinden dönüşler arasında taşınabilir. Böylece çok turlu bir ajan, her istekte bağlamını sıfırdan kurmak zorunda kalmaz.

Ayrıca, orijinal görüntü boyutlarını koruyan original ve auto gibi yeni görüntü detay ayarları bulunur. İstek şemaları ve parametreler için OpenAI API referansını kontrol edin.

GPT-5.5'ten geçiş

Geçişi yalnızca bir model slug değişimi olarak ele almayın. GPT-5.5 API kılavuzundaki iş akışını kullanıyorsanız, aşağıdaki üç adımı uygulayın.

1. Daha düşük akıl yürütme çabasını test edin

Mevcut GPT-5.5 ayarınızı ve bir seviye daha düşük çabayı aynı görev setinde karşılaştırın. GPT-5.6, birçok iş yükünde daha düşük çabayla kaliteyi koruyabilir. Bu doğrudan maliyet düşüşü sağlayabilir.

2. Kısalık yönergelerini kaldırıp tekrar ölçün

GPT-5.6, daha az genel girişle daha kısa çıktılar üretebilir. Bilgi istemlerinizde şunlar gibi yönergeler varsa, kaldırıp yeniden test edin:

• “Öz ol”
• “Girişi atla”
• “Tek paragraf yaz”
• “Açıklama ekleme”

Birikmiş kısalık yönergeleri yeni modelde çıktıyı gereğinden fazla kısaltabilir. Simon Willison'ın lansman günü yazısı, model ailesinin pratik davranışına dair bağımsız bir değerlendirme sunar.

3. Önbellek kullanımını ve görev sonuçlarını izleyin

Ayar yaparken yanıtlardaki önbelleğe alınmış jeton kullanımını takip edin. Üretim trafiğini taşımadan önce temsili görev setinizi Terra üzerinde karşılaştırın. GPT-5.5 benzeri çıktıyı daha düşük maliyetle elde edip etmediğinizi kendi verinizle doğrulayın.

Apidog'da API'yi test etme

Curl, uç noktanın çalıştığını doğrular. Ancak üç katman arasında karar vermek için tekrar edilebilir bir test düzeneğine ihtiyacınız vardır. Apidog'u indirin ve küçük bir karşılaştırma ortamı kurun.

1. OPENAI_API_KEY ile birlikte üç değişken tanımlayın:

   MODEL_SOL=gpt-5.6-sol
   MODEL_TERRA=gpt-5.6-terra
   MODEL_LUNA=gpt-5.6-luna

1. POST /v1/responses veya POST /v1/chat/completions isteği oluşturun.

2. İstek gövdesinde model alanını ortam değişkeniyle kullanın:
   

   {
     "model": "{{MODEL_SOL}}",
     "input": "Review this API design for edge cases."
   }

1. İsteği iki kez kopyalayın ve sırasıyla {{MODEL_TERRA}} ile {{MODEL_LUNA}} kullanın.

2. Aynı üretim odaklı bilgi istemini üç isteğe de gönderin.

3. Yanıtları yan yana karşılaştırın:

   • Çıktı kalitesi
   • Ton ve uzunluk
   • Gecikme
   • Kullanım verileri
   • Tahmini istek maliyeti

Her yanıttaki kullanım bloğundaki jeton sayılarını ilgili katmanın oranıyla çarpın. Böylece genel karşılaştırmalar yerine kendi bilgi istemlerinize göre maliyet hesabı yapabilirsiniz.

Bu düzenek akıl yürütme çabasını ayarlarken de kullanılabilir. Kaydedilmiş bir istekte yalnızca reasoning.effort değerini değiştirin, yeniden gönderin ve çıktı jetonları ile kalite farkını izleyin.

Sıkça Sorulan Sorular

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

Evet. 9 Temmuz 2026'dan itibaren herhangi bir OpenAI API hesabı üç modeli de doğrudan çağırabilir. API erişimi ChatGPT planınıza bağlı değildir. Plan katmanları sohbet ürününü etkiler; burada Ücretsiz ve Go kullanıcıları Terra'yı alırken ü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 jeton bağlam penceresi
• 128K maksimum çıktı
• 16 Şubat 2026 bilgi kesme tarihi

sunmaktadır. Bu değerleri hesabınız için doğrulayana kadar rapor edilen rakamlar olarak değerlendirin; kayıt kaynağı OpenAI model sayfasıdır.

Pro modu ile Ultra arasındaki fark nedir?

Pro modu, üç modelde de çalışan bir API ayarıdır:

{
  "reasoning": {
    "mode": "pro"
  }
}

Kaliteyi hıza göre önceliklendirir.

Ultra ise varsayılan olarak dört ajanı paralel çalıştıran çoklu ajan ayarıdır. Pro ve Kurumsal planlardaki ChatGPT Work'te, ayrıca Plus'tan itibaren Codex'te bulunur. GPT-5.6 Ultra mod dökümü, ekstra jeton harcamanın ne zaman anlamlı olduğunu açıklar.

Sohbet Tamamlamaları mı, Yanıtlar API'si mi?

Mevcut Sohbet Tamamlamaları kodunuz model kimliğini değiştirerek çalışmaya devam eder; zorunlu bir yeniden yazım yoktur.

Yeni projelerde Yanıtlar API'sini kullanın. Programatik araç çağırma, çoklu ajan ve kalıcı akıl yürütme bu yüzeyde sunulmuştur ve OpenAI'ın GPT-5.6 dokümantasyonu buraya odaklanır.

Sonraki adımlar

Başlamak için ayrı bir geçiş projesi oluşturmanız gerekmez:

1. Terra'yı seçin.
2. Ürününüzden gerçek bir bilgi istemini medium çabayla çalıştırın.
3. Aynı isteği bir seviye daha düşük çabayla yeniden çalıştırın.
4. Kalite, gecikme ve maliyeti karşılaştırın.
5. Büyük, statik bir sistem önekiniz varsa açık önbellekleme ekleyin.
6. Sonuçlara göre yalnızca gerekli yolları Sol'a yükseltin veya Luna'ya taşıyın.

Sol, Terra ve Luna kendi hızlarında ilerleyeceği için üç katmanlı karşılaştırma düzeneğini koruyun. Apidog, istekleri, ortamları ve jeton sayılarını tek yerde tutarak sonraki model lansmanlarını tahmin işi yerine kısa bir regresyon testine dönüştürür.