Claude Fable 5.1'e Geçiş: Fable 5 veya Opus 5'ten Tüm Kırıcı Değişiklikler

Claude Fable 5.1'e geçiş çoğunlukla model kimliğini değiştirmekten ibarettir. API yüzeyi, limitler, jeton başına fiyatlandırma, tokenize edici, her zaman açık uyarlanabilir düşünme ve reddetme yönetimi Fable 5 ile aynıdır. Ancak Fable 5'in döndürmediği üç yeni hata vardır. Bunlardan biri, geçmiş düzenleme kontrolü, bir yıldır sorunsuz çalışan istemci altyapısını sessizce bozabilir. Opus 5'ten geçişte dört değişiklik daha dikkate alınmalıdır.

Apidog'u bugün deneyin

Bu kılavuz, Anthropic'in geçiş kılavuzundan ve Claude Fable 5.1'deki Yenilikler belgesinden derlenmiş bir kontrol listesidir. Her adım, karşılaşma olasılığınıza göre sıralanır; hata metinleri, düzeltmeler ve üretim öncesi test önerileri içerir. Genel bakış için Claude Fable 5.1 nedir? yazısıyla başlayabilirsiniz.

Adım 0: Geçiş gerekip gerekmediğini doğrulayın

Anthropic, Opus 5 ile başlamanızı; Fable 5.1'i ise yoğun mantık yürütme, uzun süreli ajan çalışmaları veya Opus 5 değerlendirmelerinin yüksek çabayla bile yetersiz kaldığı senaryolar için kullanmanızı öneriyor.

Opus 5 değerlendirmelerinizi geçiyorsa Fable 5.1, belirgin bir kazanım olmadan jeton maliyetinizi iki katına çıkarabilir. Fable 5 kullanıyorsanız Fable 5.1 aynı liste fiyatına, daha ucuz önbellek okumalarına ve iddia edilen daha iyi sonuçlara sahiptir. Bu durumda temel soru, uygulamanızın ne kadar yoğun donanım çalışması gerektirdiğidir. Karşılaştırmalar için:

• Fable 5.1 ve Fable 5
• Fable 5.1 ve Opus 5

Geçişten önce şu üç uygunluk kontrolünü yapın:

• Veri saklama: Fable 5.1, 30 günlük veri saklama gerektirir. Anthropic açıkça yetki vermedikçe sıfır veri saklama (ZDR) kapsamında kullanılamaz. ZDR kullanan bir kuruluş, başka bir belirti olmadan her istekte 400 invalid_request_error alır. Opus 5, ZDR altında kullanılabilir.
• Öncelik Katmanı: Fable 5.1 tarafından desteklenmez; Fable 5 destekler.
• Oran limitleri: Fable 5.1 ve Fable 5, tek bir Fable 5.x havuzunu paylaşır. Kademeli geçiş aynı boş kapasiteden yararlanır.

Adım 1: Model adını güncelleyin

model = "claude-fable-5"    # Önce
model = "claude-opus-5"     # Veya önce
model = "claude-fable-5-1"  # Sonra

Amazon Bedrock'taki model kimliği:

anthropic.claude-fable-5-1

Google Cloud, Microsoft Foundry ve AWS üzerindeki Claude Platformu claude-fable-5-1 kullanır. Claude Yönetilen Aracıları kullanıyorsanız gereken tek değişiklik model adıdır.

Kritik değişiklik 1: Zorunlu araç kullanımı artık 400 döndürüyor

Fable 5, tool_choice için auto, none, any ve tool değerlerini kabul ediyordu. Fable 5.1 ise Messages API, Batches API ve jeton sayma uç noktasında tool ve any değerlerini reddeder:

tool_choice: type "tool" and "any" are not supported for this model.

Anthropic'e göre neden, her zaman açık düşünmenin zorunlu çağrıyla atlanması ve modelin düşünme sürecini araç bağımsız değişkenlerine yazabilmesidir.

Önce: Fable 5

response = client.messages.create(
    model="claude-fable-5",
    max_tokens=16000,
    tools=[record_summary_tool],
    tool_choice={"type": "tool", "name": "record_summary"},
    messages=[{"role": "user", "content": "Summarize: The meeting moved to Thursday."}],
)

Sonra: Fable 5.1

tool_choice değerini auto olarak bırakın, araç adını talimatta açıkça belirtin ve bağımsız değişkenlerin şemanızla eşleşmesini sağlamak için strict: true kullanın. Katı araç kullanımı hakkında daha fazla bilgi edinin.

record_summary_tool["strict"] = True
record_summary_tool["input_schema"]["additionalProperties"] = False

response = client.messages.create(
    model="claude-fable-5-1",
    max_tokens=16000,
    tools=[record_summary_tool],
    tool_choice={"type": "auto"},
    messages=[{
        "role": "user",
        "content": (
            "Summarize: The meeting moved to Thursday. "
            "Call the record_summary tool with your result."
        ),
    }],
)

Kullanım amacına göre şu geçişleri yapın:

• JSON döndürmek için bir aracı zorladıysanız output_config.format ile yapılandırılmış çıktılara geçin.
• Uygulama o turda araç çağrısını gerektiriyorsa, son kullanıcı mesajından sonra aracı adlandıran ve çağrının gerekli olduğunu belirten bir role: "system" mesajı ekleyin. Bu mesajı sonraki geçmişte koruyun.
• any ile “tam olarak bir araç” davranışına güveniyorsanız disable_parallel_tool_use: true, auto ile birlikte hâlâ çalışır; ancak artık en fazla bir çağrı anlamına gelir.
• Araç çağrısı gelmediğinde çalışan yeniden deneme döngülerini kaldırın. Anthropic, Fable 5.1'in açık araç talimatlarını güvenilir biçimde izlediğini belirtiyor.
• CMEK kullanan kuruluşlarda Fable modelleri için strict: true ve yapılandırılmış çıktılar mevcut değildir. Bu durumda yalnızca açık talimatlara güvenin.

Kritik değişiklik 2: Eski modeller Fable 5.1 düşünme bloklarını okuyamaz

Her düşünme bloğu, onu üreten modeli kaydeder. Fable 5.1 şu modellerden gelen blokları okuyabilir:

• Opus 5
• Fable 5
• Mythos 5
• Daha önceki modeller

Bu nedenle mevcut bir konuşmayı Fable 5.1'e taşırken akıl yürütmeyi koruyabilirsiniz. Ancak Mythos 5.1 dışında hiçbir model Fable 5.1 bloğunu okuyamaz.

Bir Fable 5.1 konuşması yönlendirici anahtarı, istemci tarafı yeniden denemesi veya sınıflandırıcı geri dönüşü nedeniyle eski bir modele düşebilir. API, hedef model blokları görmeden önce bunları düşürür. İstek başarılı olur ve düşürülen jetonlar faturalandırılmaz; ancak hedef model akıl yürütme olmadan yeniden planlama yaptığından geçişten sonraki ilk turda maliyet ve gecikme artabilir.

Kodda yapılması gereken bir blok dönüşümü yoktur. Düşünme bloklarını değiştirmeden geri gönderin. Bunları kendiniz kaldırmak imza doğrulama hatalarına yol açabilir.

Görünürlüğü artırmak için şu beta başlığını gönderin:

thinking-binding-controls-2026-08-01

Yanıt, reason: "model_binding_mismatch" ile düşürülen blokları input_transformations içinde bildirir.

Kritik değişiklik 3: Önceki dönüşleri düzenlemek düşünme bloklarını geçersiz kılar

Bir Fable 5.1 düşünme bloğu, kendisinden önce gelen şu içeriğe bağlıdır:

• Tam system komut istemi
• tools dizisi
• Mesaj geçmişi
• Korunmuş düşünme blokları

Geçmiş düzenleme kontrolünün uygulandığı hesaplarda bu içeriklerden biri değiştikten sonra bloğu yeniden oynatmak isteği reddeder:

messages.5.content.0: Invalid `signature` in `thinking` block. The block is bound to a different conversation. Remove the block, or set `thinking.block_binding.prefix_mismatch_behavior` to "drop_block". That setting requires the `thinking-binding-controls-2026-08-01` value in the `anthropic-beta` header.

Kimler için geçerli?

31 Ağustos 2026 tarihinde veya sonrasında oluşturulan hesaplarda kontrol varsayılan olarak uygulanır. Daha eski hesaplar uyumsuzluğu kaydeder; yalnızca istek thinking.block_binding.prefix_mismatch_behavior değerini ayarlarsa buna göre hareket eder. Anthropic, gelecekte bu kontrolü tüm hesaplar için uygulamayı planlıyor.

Başkalarının kendi API anahtarlarıyla çalıştırdığı bir araç gönderiyorsanız bu alanı açıkça ayarlayarak test edin. Yeni hesap kullanan kişiler bu kuralla sizden önce karşılaşabilir.

Claude Code, claude.ai, Yönetilen Aracılar ve Agent SDK öneki sizin için tutarlı tutar. Mythos 5.1 ise bu kontrolü hiç çalıştırmaz.

Hangi değişiklikler sonraki blokları geçersiz kılar?

• Önceki bir dönüşü düzenlemek, yeniden sıralamak veya kaldırmak; buna eski araç sonuçlarını silmek de dahildir.
• Bir sonraki istekte kaldıracağınız istek başına metin eklemek.
• İstekler arasında system veya tools içeriğini yeniden oluşturmak.
• Daha sonra farklı baytlar döndüren bir görsel URL'si kullanmak.

Hangi değişiklikler güvenlidir?

• Yalnızca yeni mesaj eklemek.
• En eski düşünme bloklarını baştan başlayarak kaldırmak.
• system, tools ve messages dışındaki parametreleri değiştirmek.
• cache_control işaretçilerini taşımak.
• Sunucu tarafı sıkıştırma veya bağlam düzenleme kullanmak.

Kurtarma: Uyumsuz bloğu düşürün

Beta başlığını gönderin ve davranışı drop_block olarak ayarlayın:

response = client.beta.messages.create(
    model="claude-fable-5-1",
    max_tokens=16000,
    thinking={
        "type": "adaptive",
        "block_binding": {
            "prefix_mismatch_behavior": "drop_block"
        },
    },
    betas=["thinking-binding-controls-2026-08-01"],
    messages=history,
)

for t in response.input_transformations or []:
    print(t.path, t.reason)
    # prefix_binding_mismatch veya model_binding_mismatch

API, ilk uyumsuz bloğu ve ondan sonraki tüm düşünme bloklarını düşürür, işlemeye devam eder ve her düşürmeyi raporlar. Bu davranış yalnızca mevcut istek için geçerlidir; bu nedenle alanı sonraki isteklere de göndermeye devam edin.

Bir geçmiş düzenlemesinin çalışmayı durdurmasını istiyorsanız CI ortamında açıkça error ayarlayın. Korunmuş düşünme kılavuzu, üç adımlı denetimi ve bozulmaya yol açan yaygın sıkıştırma biçimlerini açıklar.

Opus 5'ten geliyorsanız: dört ek değişiklik

1. Düşünme hiçbir çabayla devre dışı bırakılamaz

Opus 5, high veya daha düşük seviyelerde aşağıdaki ayarı kabul ediyordu:

thinking={"type": "disabled"}

Fable 5.1 bu ayarla her çaba seviyesinde 400 döndürür. Alanı kaldırın, daha düşük çabayla harcamayı kontrol edin ve düşünmeden çalışan rotalar için max_tokens değerini yeniden değerlendirin.

2. Araçlar arasındaki anlatım düşünme bloklarına taşınır

Opus 5'te araç çağrıları arasındaki anlatım text blokları olarak dönerdi. Fable 5.1'de bu ilerleme güncellemeleri, varsayılan display: "omitted" altında boş olan düşünme bloklarına taşınır.

Kullanıcı arayüzünüz bu anlatımı gösteriyorsa şu beta başlığıyla güncellemeleri etkinleştirin:

thinking={
    "type": "adaptive",
    "display": "updates",
}

thinking-display-updates-2026-08-18

3. Sınıflandırıcı kümesi daha geniştir

Opus 5 yalnızca siber sınıflandırıcıları çalıştırırken Fable 5.1 şu kümeleri kapsar:

• cyber
• bio
• frontier_llm
• reasoning_extraction
• general_harms

Yanıt içeriğini okumadan önce stop_reason: "refusal" durumunu ele alın. Ayrıca server-side-fallback-2026-07-01 beta başlığıyla fallbacks: "default" seçeneğini etkinleştirin.

İzin verilen geri dönüş hedefleri Opus 4.8 ve Opus 5'tir. Reddedilen bir istek, geçiş yaptığınız modele geri dönebilir.

4. Fiyat ve veri saklama değişir

Opus 5'ten Fable 5.1'e geçişte:

• Girdi fiyatı $5 yerine $10
• Çıktı fiyatı $25 yerine $50
• Önbellek okuma fiyatı $0.50 yerine $0.25
• ZDR desteği yok

Ayrıntılı hesaplama için Claude Fable 5.1 fiyatlandırma dökümüne bakın.

Opus 4.8 veya daha eski bir sürümden geliyorsanız önce Opus 4.8'den Opus 5'e geçişi tamamlayın, ardından bu kılavuzu uygulayın. Opus 4.8 için yazılmış entegrasyonlar genellikle eski dönüşleri keser veya her istekte system komut istemini yeniden oluşturur; Opus 4.8 bu davranışa itiraz etmiyordu.

Hata döndürmeyen davranış değişiklikleri

Bu değişikliklerin her birinin istem kılavuzunda tek satırlık bir düzeltmesi vardır:

• Uzun döngülerde Fable 5.1, Fable 5'in birkaç çağrıyı toplu işlediği durumlarda her dönüşte bir araç çağrısı yapabilir. Çoklu çağrı dönüşlerinin oranını ölçün; oran düşerse isteminize toplu işlemeyi teşvik eden bir talimat ekleyin.
• Daha az ilerleme mesajı üretir. Gerekliyse display: "updates" ayarlayın ve bulguları saklamasını isteyen artık gereksiz istem satırlarını kaldırın.
• low çabada arama araçlarını daha az çağırabilir. Taze veriye ihtiyaç duyan dönüşlerde çaba seviyesini artırın.

Daha fazla istem önerisi için Claude Fable 5.1 istem kılavuzuna bakın.

Önerilen değişiklikler

Mesaj başına çaba

mid-conversation-output-config-2026-07-01 beta özelliğini kullanarak çabayı mesaj bazında değiştirin. Önbelleği sıfırlayan en üst düzey değeri değiştirmek yerine, output_config içeren boş içerikli bir role: "system" mesajı gönderin.

Yüksek çabayla başlayıp tarayın

high ile başlayın. Anthropic'e göre Fable 5.1'in Fable 5'e kıyasla en büyük kazanımları xhigh ve max seviyelerinde görülür. medium seviyesi ise daha düşük maliyetle Fable 5'e yaklaşık olarak eşdeğerdir.

Çaba seviyesi adlarının modeller arasında taşınacağını varsaymayın.

Bağlamı sunucuda yönetin

Sunucu tarafı sıkıştırma (compact-2026-01-12) ve bağlam düzenleme, geçmiş düzenlemesi olarak değerlendirilmez. Geçmişi istemci tarafında yeniden yazmak yerine bu özellikleri kullanın.

Geçiş kontrol listesi

• [ ] 30 günlük veri saklamayı ve Öncelik Katmanı bağımlılığınız olmadığını doğrulayın.
• [ ] Model adını claude-fable-5-1 olarak güncelleyin.
• [ ] any veya tool tipindeki her tool_choice kullanımını auto ve açık bir araç talimatıyla değiştirin; mümkünse strict: true ekleyin veya yapılandırılmış çıktılara geçin.
• [ ] Opus 5'ten geliyorsanız thinking: {"type": "disabled"} ayarını kaldırın ve max_tokens değerini yeniden değerlendirin.
• [ ] Boş olanlar da dahil olmak üzere tüm düşünme bloklarını her dönüşte değiştirmeden geri gönderin.
• [ ] Mesaj geçmişi oluşturuyorsanız prefix_mismatch_behavior: "drop_block" ile bir oturum çalıştırın ve input_transformations değerlerini günlüğe kaydedin.
• [ ] Her prefix_binding_mismatch olayını düzeltin.
• [ ] Oturum başlangıcında system ve tools içeriğini sabitleyin.
• [ ] Dönüş hatırlatıcılarını, silinmeyen dönüş kapsamlı system mesajlarına taşıyın.
• [ ] Üretimde kullanacağınız prefix_mismatch_behavior değerini belirleyip izleyin.
• [ ] stop_reason: "refusal" durumunu ele alın ve fallbacks: "default" seçeneğini ekleyin.
• [ ] Kullanıcı arayüzünüz araçlar arası anlatımı işliyorsa display: "updates" ayarlayın.
• [ ] high seviyesinden başlayarak çaba taramasını yeniden çalıştırın ve maliyeti yeniden hesaplayın.
• [ ] Jeton sayılarının Fable 5'ten değişmediğini, önbellek okumalarının ise fiyatın dörtte birine indiğini doğrulayın.

Kontrol listesini Apidog'da çalıştırma

Her kritik değişiklik için bir istek içeren bir koleksiyon oluşturun:

1. Zorunlu tool_choice çağrısı; 400 bekleyin.
2. thinking: {"type": "disabled"} çağrısı; 400 bekleyin.
3. Düşünme bağlama başlığı etkin durumdayken dönüşler arasında system komut istemini değiştiren iki istekli bir sıra; prefix_binding_mismatch girişi bekleyin.

Başarılı sürümleri de koleksiyona ekleyin. Bu sürümlerde stop_reason doğrulaması ve boş bir input_transformations dizisi bulunsun. Her uygulama değişikliğinde koleksiyonu Apidog CLI üzerinden CI'da çalıştırın.

Koleksiyonu oluşturmak için Apidog'u indirin; istek gövdeleri Claude Fable 5.1 API tanıtımında yer alır.

Sıkça Sorulan Sorular

Fable 5'ten Fable 5.1'e geçiş doğrudan mıdır?

Çoğunlukla evet. Ancak zorunlu tool_choice kullanımı 400 döndürür, eski modeller Fable 5.1 düşünme bloklarını okuyamaz ve uygulanan hesaplarda önceki dönüşleri düzenlemek sonraki düşünme bloklarını geçersiz kılar. Diğer davranışların çoğu aktarılır.

“Farklı bir konuşmaya bağlı” ne anlama gelir?

Kodunuz, bir Fable 5.1 düşünme bloğundan önce konuşmanın bir bölümünü değiştirmiş ve bloğu yeniden oynatmıştır. Geçmiş düzenlemeyi bırakın veya thinking-binding-controls-2026-08-01 başlığıyla birlikte prefix_mismatch_behavior: "drop_block" gönderin.

Hesabım geçmiş düzenleme kontrolünü uyguluyor mu?

Hesap 31 Ağustos 2026 tarihinde veya sonrasında oluşturulduysa evet. Daha eski hesaplar kontrolü yalnızca prefix_mismatch_behavior ayarlandığında uygular.

Fable 5 istemlerimi kullanmaya devam edebilir miyim?

Evet. Anthropic, değişiklik yapılmadan da iyi performans göstermeleri gerektiğini belirtiyor. Yine de çaba taramasını yeniden çalıştırın ve uzun döngülerde daha az paralel araç çağrısı bekleyin.

Opus 5'ten geçişte neler bozulur?

Fable 5 geçişindeki tüm değişikliklere ek olarak:

• thinking: {"type": "disabled"} her çaba seviyesinde 400 döndürür.
• Araçlar arası anlatım düşünme bloklarına taşınır.
• Sınıflandırıcı kümesi genişler.
• Fiyat iki katına çıkar.
• ZDR desteği kaybolur.

Bedrock ve Google Cloud aynı kritik değişikliklere sahip mi?

Model adı değişiklikleri evet. Düşünme bağlama kontrolleri lansmanda Claude API ve AWS üzerindeki Claude Platformunda mevcuttu; Bedrock ve Google Cloud'da model başına kullanıma sunuluyor.

Kontroller mevcut değilse kurtarma yöntemi, düşünme bloklarını kaldırıp isteği bir kez yeniden denemektir.

Kaynaklar

• Anthropic geçiş kılavuzu
• Claude Fable 5.1'deki Yenilikler
• Apidog
• Claude Fable 5.1 nedir?
• Fable 5.1 ve Fable 5 karşılaştırması
• Fable 5.1 ve Opus 5 karşılaştırması
• Katı araç kullanımı
• Korunmuş düşünme
• claude.ai
• Korunmuş düşünme kılavuzu
• Fiyatlandırma dökümü
• Opus 4.8'den Opus 5'e geçiş
• Fable 5.1 istem kılavuzu
• Apidog'u indirin
• Fable 5.1 API tanıtımı