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.
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.
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:
Geçişten önce şu üç uygunluk kontrolünü yapın:
400 invalid_request_error
alır. Opus 5, ZDR altında kullanılabilir.Fable 5.x
havuzunu paylaşır. Kademeli geçiş aynı boş kapasiteden yararlanır.
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.
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.
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."}],
)
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:
output_config.format
ile yapılandırılmış çıktılara geçin.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.strict: true
ve yapılandırılmış çıktılar mevcut değildir. Bu durumda yalnızca açık talimatlara güvenin.Her düşünme bloğu, onu üreten modeli kaydeder. Fable 5.1 şu modellerden gelen blokları okuyabilir:
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.
Bir Fable 5.1 düşünme bloğu, kendisinden önce gelen şu içeriğe bağlıdır:
tools
dizisiGeç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.
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.
system
veya tools
içeriğini yeniden oluşturmak.system
, tools
ve messages
dışındaki parametreleri değiştirmek.cache_control
işaretçilerini taşımak.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)
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.
| Yapıyordunuz | Bunun yerine |
|---|---|
Oturum ortasında system içeriğini düzenlemek |
|
Oturum başlangıcında sabitleyin. Değişikliğin geçerli olduğu yere role: "system" mesajı ekleyin. |
|
Oturum ortasında tools içeriğini düzenlemek |
|
Tam araç setini baştan bildirin. tool_addition veya tool_removal bloklarını system mesajıyla gönderin ve mid-conversation-tool-changes-2026-07-01 beta özelliğini kullanın. |
|
| Her dönüşte bir hatırlatıcı ekleyip silmek | |
clear_at: "next_user_message" kullanan dönüş kapsamlı bir system mesajı gönderin. mid-conversation-system-clear-at-2026-08-21 beta özelliğini kullanın. |
|
| Eski araç sonuçlarını istemci tarafında silmek | Sunucu tarafı bağlam düzenlemesini kullanın. |
| Son dönüşleri kelimesi kelimesine koruyan istemci tarafı sıkıştırma yapmak | Sunucu tarafı sıkıştırma veya bir özet mesajı ile yeni kullanıcı dönüşü kullanın; eski içeriği yeniden oynatmayın. |
| Dönüşler arasında bir görsele URL ile yeniden başvurmak | Görseli bir kez Dosyalar API'sine yükleyin ve sonraki isteklerde file_id gönderin. |
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.
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
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.
Opus 5'ten Fable 5.1'e geçişte:
$5
yerine $10
$25
yerine $50
$0.50
yerine $0.25
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.
Bu değişikliklerin her birinin istem kılavuzunda tek satırlık bir düzeltmesi vardır:
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.
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.
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.
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.
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.thinking: {"type": "disabled"}
ayarını kaldırın ve max_tokens
değerini yeniden değerlendirin.prefix_mismatch_behavior: "drop_block"
ile bir oturum çalıştırın ve input_transformations
değerlerini günlüğe kaydedin.prefix_binding_mismatch
olayını düzeltin.system
ve tools
içeriğini sabitleyin.prefix_mismatch_behavior
değerini belirleyip izleyin.stop_reason: "refusal"
durumunu ele alın ve fallbacks: "default"
seçeneğini ekleyin.display: "updates"
ayarlayın.high
seviyesinden başlayarak çaba taramasını yeniden çalıştırın ve maliyeti yeniden hesaplayın.Her kritik değişiklik için bir istek içeren bir koleksiyon oluşturun:
tool_choice
çağrısı; 400
bekleyin.thinking: {"type": "disabled"}
çağrısı; 400
bekleyin.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.
Ç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.
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.
Hesap 31 Ağustos 2026 tarihinde veya sonrasında oluşturulduysa evet. Daha eski hesaplar kontrolü yalnızca prefix_mismatch_behavior
ayarlandığında uygular.
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.
Fable 5 geçişindeki tüm değişikliklere ek olarak:
thinking: {"type": "disabled"}
her çaba seviyesinde 400 döndürür.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.