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 bir model-ID değişimiyle gerçekleşir. 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 üç değişiklik Fable 5'in hiç vermediği hataları döndürüyor ve bunlardan biri, geçmiş düzenleme kontrolü, bir yıldır sorunsuz çalışan bir aracı donanımını sessizce bozabilir. Opus 5'ten gelmek dört madde daha ekler.

Bu kılavuz, Anthropic'in geçiş kılavuzundan ve Claude Fable 5.1'deki Yenilikler belgesinden derlenen, her bir öğe için tam hata metni ve düzeltmeyi içeren, karşılaşacağınız sıraya göre düzenlenmiş bir kontrol listesidir. Her kod parçacığı, üretime geçmeden önce Apidog'a yapıştırılabilir ve gerçek uç noktaya karşı çalıştırılabilir. Modelin genel görünümü için, Claude Fable 5.1'in ne olduğundan başlayın.

Adım 0: Hiç geçiş yapmanız gerekip gerekmediğini doğrulayın

Anthropic'in belgeleri, Opus 5 ile başlamayı ve Fable 5.1'i “yoğun mantık yürütme ve uzun vadeli ajan çalışmaları için veya Claude Opus 5'teki değerlendirmelerinizin daha yüksek çabayla bile yetersiz kaldığı durumlarda” kullanmayı öneriyor. Eğer Opus 5 değerlendirmelerinizi geçiyorsa, geçiş belirgin bir kazanç olmadan jeton başına fiyatınızı ikiye katlar. Eğer Fable 5 kullanıyorsanız, daha ucuz önbellek okumaları ve iddia edilen daha iyi sayılarla aynı fiyata sahiptir, bu yüzden tek soru ne kadar donanım çalışması gerektirdiğidir. Fable 5.1 ile Fable 5 ve Fable 5.1 ile Opus 5 karşılaştırmaları bu kararı kapsar.

Önce üç uygunluk kontrolü:

• Veri saklama. Fable 5.1, 30 günlük veri saklama gerektirir ve Anthropic açıkça yetki vermedikçe sıfır veri saklama altında mevcut değildir. Sıfır veri saklama (ZDR) kullanan bir kuruluş, başka hiçbir ipucu olmaksızın her istekte 400 invalid_request_error hatası alır. Opus 5, ZDR altında mevcuttur.
• Öncelik Katmanı. Fable 5.1'de desteklenmez. Fable 5 destekler.
• Oran limitleri. Fable 5.1, Fable 5 ile tek bir “Fable 5.x” havuzunu paylaşır, bu nedenle kademeli bir 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'ta kimlik anthropic.claude-fable-5-1'dir. Google Cloud, Microsoft Foundry ve AWS'deki Claude Platformu claude-fable-5-1 kullanır. Claude Yönetilen Aracıları kullanıyorsanız, gereken tek değişiklik budur.

Kritik değişiklik 1: zorunlu araç kullanımı 400 hatası döndürür

Fable 5, tool_choice değerleri olarak auto, none, any ve tool'u kabul ediyordu. Fable 5.1, Messages API, Batches API ve jeton sayma uç noktasında son ikisini reddeder:

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

Anthropic'in nedeni: Düşünme her zaman açık olduğundan, zorunlu bir çağrı bunu atlayacak ve model işleyişini araç argümanlarına yazacaktı.

Ö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, talimatta aracı adlandırın ve bağımsız değişkenlerin şemanızla hala eşleştiğinden emin olmak için strict: true (katı araç kullanımı) ayarlayın.

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."}],
)

Amaca göre geçiş yapın. JSON geri almak için bir aracı zorladıysanız, bunu yapılandırılmış çıktılarla (output_config.format) değiştirin. Uygulama bu turda çağrıyı gerektiriyorsa, en son kullanıcı dönüşünden sonra aracı adlandıran ve çağrının gerekli olduğunu belirten bir role: "system" mesajı ekleyin ve bunu daha sonra geçmişte tutun. Eğer “tam olarak bir araç” için any'ye güvendiyseniz, disable_parallel_tool_use: true hala auto ile çalışır ancak artık en fazla bir çağrı anlamına gelir. Eksik araçta yeniden deneme döngülerini silin; Anthropic, Fable 5.1'in açık araç talimatlarını güvenilir bir şekilde takip ettiğini belirtiyor. CMEK kuruluşunda, Fable modellerinde strict: true ve yapılandırılmış çıktılar mevcut değildir, bu nedenle yalnızca talimata 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, Opus 5, Fable 5, Mythos 5 ve önceki modellerden gelen blokları okur, bu nedenle Fable 5.1'e taşınan bir konuşma akıl yürütmesini korur. Mythos 5.1 dışında hiçbir model bir Fable 5.1 bloğunu okuyamaz.

Bir Fable 5.1 konuşması, bir yönlendirici anahtarı, istemci tarafı yeniden deneme veya sınıflandırıcı reddetme geri dönüşü yoluyla eski bir modele düşebilir. Her durumda API, o modelin okuyamadığı blokları görmeden önce düşürür. İstek başarılı olur, düşürülen jetonlar faturalandırılmaz ve hedef model akıl yürütme olmadan yeniden planlama yapar, bu da geçişten sonraki ilk turda maliyeti ve gecikmeyi artırır.

Kodda düzeltilecek bir şey yok. Düşünme bloklarını değiştirmeden geri geçirmeye devam edin; bunları kendiniz kaldırmak imza 400 hatalarını tetikleyebilir. Görünürlük için, thinking-binding-controls-2026-08-01 beta başlığını gönderin ve yanıt, reason: "model_binding_mismatch" ile düşürülen her bloğu adlandıran bir input_transformations dizisi taşır.

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

Bu, zaman ayırmanız gereken bir maddedir. Bir Fable 5.1 düşünme bloğu, yalnızca kendisinden önce gelen tam system komut istemi, tools dizisi ve mesaj geçmişi (korunmuş düşünme) karşısında geçerlidir. Kontrolün uygulandığı durumlarda, bunlardan herhangi biri değiştikten sonra bir bloğu tekrar oynatan bir istek reddedilir:

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 hesaplar. Daha eski hesaplar uyumsuzluğu kaydeder ancak yalnızca istek thinking.block_binding.prefix_mismatch_behavior değerini ayarlarsa buna göre hareket eder. Anthropic, gelecek modellerin bunu her hesap için uygulayacağını belirtiyor. Başkalarının kendi API anahtarlarıyla çalıştırdığı bir araç gönderiyorsanız, alanı ayarlanmış olarak test edin: yeni hesaplardaki kullanıcılarınız size kıyasla daha önce bu kurala tabi olur. Claude Code, claude.ai, Yönetilen Aracıları ve Agent SDK sizin için öneki sağlam tutar; Mythos 5.1 bu kontrolü hiç çalıştırmaz.

Daha sonraki her bloğu geçersiz kılan şeyler: önceki bir dönüşü düzenlemek, yeniden sıralamak veya kaldırmak (eski araç sonuçlarını silmek dahil); bir sonraki istekte kaldıracağınız istek başına metin eklemek; istekler arasında system veya tools'u yeniden oluşturmak; daha sonra farklı baytlar sunan bir resim URL'si. Blokları geçerli tutan şeyler: yalnızca eklemeli geçmişler, en eski düşünme bloklarını baştan başlayarak kaldırmak, system, tools ve messages dışındaki herhangi bir parametreyi değiştirmek, cache_control işaretçilerini taşımak ve sunucu tarafı sıkıştırma veya bağlam düzenleme.

Kaçış yolu. Beta başlığını gönderin ve alanı "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 or model_binding_mismatch

API, ilk uyuşmayan bloğu ve ondan sonraki her düşünme bloğunu düşürür, işleme devam eder ve her düşürmeyi raporlar. Bu yalnızca o istek için geçerlidir, bu nedenle alanı göndermeye devam edin. Bir geçmiş düzenlemesinin çalışmayı başarısız kılması için CI'da açıkça "error" ayarlayın. Korunmuş düşünme kılavuzu, üç adımlı denetimi ve bozulmaya neden olan sıkıştırma şekillerini içerir. Düzeltme tablosu:

Opus 5'ten geliyorsanız: dört madde daha

1. Düşünme hiçbir çabayla devre dışı bırakılamaz. Opus 5, high veya daha düşük seviyede thinking: {"type": "disabled"}'ı kabul ediyordu. Fable 5.1 her çabada 400 hatası 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'i tekrar gözden geçirin.

2. Araçlar arası anlatım düşünme bloklarına taşınır. Opus 5'te, araç çağrıları arasındaki metin text blokları olarak geri geliyordu. Fable 5.1'de, varsayılan display: "omitted" altında boş olan ilerleme-güncellemesi thinking blokları olarak geri gelir. Kullanıcı arayüzünüz bu anlatımı işlediyse, thinking-display-updates-2026-08-18 başlığıyla thinking: {"type": "adaptive", "display": "updates"} ayarlayın.

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ır. Fable 5.1 cyber, bio, frontier_llm, reasoning_extraction ve general_harms'ı kapsar. content'i okumadan önce stop_reason: "refusal"'ı ele alın ve server-side-fallback-2026-07-01 başlığıyla fallbacks: "default" seçeneğini etkinleştirin. İzin verilen hedefler Opus 4.8 ve Opus 5'tir, bu nedenle reddedilen bir istek, geçiş yaptığınız modele geri dönebilir.

4. Fiyat ve saklama. $5 ve $25 yerine $10 ve $50, önbellek okumaları ise $0.50 yerine $0.25. ZDR kaybolur. Fiyatlandırma dökümü matematiği içerir.

Opus 4.8 veya daha eski bir sürümden geliyorsanız, önce Opus 4.8'den Opus 5'e geçişi, ardından bu kılavuzu uygulayın. Opus 4.8 için yazılan entegrasyonlar genellikle eski dönüşleri keser veya her istekte sistem komut istemini yeniden oluşturur ve Opus 4.8 buna hiç itiraz etmezdi.

Test edilecek davranış değişiklikleri

Hiçbiri hata döndürmez ve 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çını toplu işlediği yerde her dönüşte bir araç çağrısı yapabilir; çoklu çağrı dönüşlerinin payını ölçün ve düştüyse toplu işleme teşvikini ekleyin. Daha az ilerleme mesajı yazar, bu nedenle display: "updates" ayarlayın ve bulguları tutmasını söyleyen istem satırlarını kaldırın. low çabada arama araçlarını daha az çağırır, bu nedenle taze verilere ihtiyaç duyan dönüşler için çabayı artırın.

Önerilen değişiklikler

• Mesaj başına çaba (beta mid-conversation-output-config-2026-07-01). Önbelleği sıfırlayan en üst düzey değeri değiştirmek yerine, output_config taşıyan boş içerikli bir role: "system" mesajıyla çabayı değiştirin.
• high ile başlayın ve tarayın. Fable 5'e göre kazanımlar xhigh ve max seviyelerinde en fazladır; Anthropic, medium seviyesinin Fable 5 ile daha düşük maliyetle yaklaşık olarak eşleştiğini belirtiyor. Seviye adları modeller arasında taşınmaz.
• Sunucuda bağlamı kırpın. Sunucu tarafı sıkıştırma (beta compact-2026-01-12) ve bağlam düzenleme geçmiş düzenlemeleri olarak sayılmaz.

Geçiş kontrol listesi

• [ ] 30 günlük veri saklamayı ve Öncelik Katmanına bağımlılığın olmadığını onaylayın.
• [ ] Model adını claude-fable-5-1 olarak güncelleyin.
• [ ] any veya tool tipindeki her tool_choice'u auto artı bir talimat ve strict: true ile veya yapılandırılmış çıktılarla değiştirin.
• [ ] Opus 5'ten geliyorsanız: thinking: {"type": "disabled"}'ı kaldırın ve max_tokens'i tekrar gözden geçirin.
• [ ] Boş olanlar da dahil olmak üzere her dönüşte düşünme bloklarını değiştirmeden geri geçirin.
• [ ] Kodunuz messages oluşturuyorsa, prefix_mismatch_behavior: "drop_block" ile bir oturum çalıştırın, input_transformations'ı günlüğe kaydedin ve her prefix_binding_mismatch'i düzeltin.
• [ ] Oturum başlangıcında system ve tools'u dondurun; her dönüş hatırlatıcılarını asla silmediğiniz dönüş kapsamlı sistem mesajlarına taşıyın.
• [ ] Bir üretim prefix_mismatch_behavior seçin ve onu izleyin.
• [ ] stop_reason: "refusal"'ı ele alın; fallbacks: "default"'ı ekleyin.
• [ ] Kullanıcı arayüzünüz araçlar arası metni işliyorsa, display: "updates" ayarlayın.
• [ ] high'dan başlayarak çaba taramasını yeniden çalıştırın ve maliyeti yeniden belirleyin. Jeton sayıları Fable 5'ten değişmedi; önbellek okumaları fiyatın dörtte biridir.

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

Her kritik değişiklik için bir istek içeren bir koleksiyon oluşturun: zorunlu bir tool_choice çağrısı (yukarıdaki 400'ü bekleyin), bir thinking: disabled çağrısı (400'ü bekleyin) ve düşünme bağlama başlığı ayarlanmış olarak dönüşler arasında sistem komut istemini düzenleyen iki istekli bir sıra (prefix_binding_mismatch girişi bekleyin). Başarılı sürümleri yanlarına stop_reason üzerinde onaylar ve boş bir input_transformations dizisi ile ekleyin ve her donanım değişikliğinde Apidog CLI aracılığıyla CI'da çalıştırın. Bunu oluşturmak için Apidog'u indirin; API tanıtımında istek gövdeleri bulunur.

Sıkça Sorulan Sorular

Fable 5'ten Fable 5.1'e geçiş doğrudan bir değişiklik mi? Çoğunlukla. Zorunlu tool_choice 400 hatası döndürür, eski modeller Fable 5.1 düşünme bloklarını okuyamaz ve önceki dönüşleri düzenlemek, uygulanan hesaplarda sonraki düşünme bloklarını geçersiz kılar. Diğer her şey aktarılır.

“Farklı bir konuşmaya bağlı” ne anlama geliyor? Kodunuz, bir Fable 5.1 düşünme bloğundan önce bir şeyi değiştirdi ve ardından bloğu tekrar oynattı. Geçmişi düzenlemeyi bırakın veya prefix_mismatch_behavior: "drop_block" ile thinking-binding-controls-2026-08-01 başlığını gönderin.

Hesabım geçmiş düzenleme kontrolünü uyguluyor mu? Eğer 31 Ağustos 2026 tarihinde veya sonrasında oluşturulduysa, evet. Daha eski hesaplar bunu yalnızca prefix_mismatch_behavior ayarını yaptığınızda uygular.

Fable 5 komut istemlerimi saklayabilir miyim? Evet. Anthropic, değişiklik yapmadan iyi performans göstermeleri gerektiğini belirtiyor. Ç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ş yaptığımda neler bozulur? Fable 5 listesindeki her şey, ayrıca thinking: disabled her çabada 400 hatası döndürür, araçlar arası anlatım düşünme bloklarına taşınır, sınıflandırıcı kümesi daha geniştir, fiyat ikiye katlanır ve ZDR kaybolur.

Bedrock ve Google Cloud aynı kritik değişikliklere sahip mi? Model değişiklikleri evet. Düşünme bağlama kontrolleri, lansmanda Claude API ve AWS üzerindeki Claude Platformunda mevcuttu ve Bedrock ile Google Cloud'da model başına gelmekte. Kontroller olmadan, kurtarma yöntemi düşünme bloklarını kaldırmak ve bir kez yeniden denemektir.