Claude Haiku 5.5 vs Haiku 4.5: Neler Değişti ve İlk Düzeltilmesi Gereken Uyumsuz Değişiklikler

Claude Haiku 5.5 (claude-haiku-5-5, 7 Ekim 2026'da yayınlandı), 100 bin tokene kadar olan istemler için Haiku 4.5'ten %90 daha az maliyetlidir (milyon giriş/çıkış token başına 0,10$/0,50$ vs 1$/5$), 200 bin yerine 1 milyon tokenlık bir bağlam penceresine sahiptir ve her iki modeli de listeleyen her lansman karşılaştırmasında çok daha yüksek puanlar almıştır. Ancak bir sorun var: 4.5'te çalışan beş istek şekli artık 400 hatası döndürüyor ve hatasız olarak yanıtları ve maliyetleri değiştiren birçok başka değişiklik de mevcut.

Aşağıda: yan yana bir tablo, önce/sonra JSON ile her bozucu değişiklik, sessiz değişiklikler ve Apidog için bir test planı. Tam özellik sayfası için Claude Haiku 5.5 nedir başlıklı yazıyı okuyun. Hala eski modeli kullanıyorsanız, Claude Haiku 4.5 API rehberimiz bunu kapsar.

Bir Bakışta Haiku 4.5 ve Haiku 5.5

Haiku 4.5 kullanımdan kaldırılmadı. Model kullanımdan kaldırma sayfası, onu herhangi bir kullanımdan kaldırma tarihi olmaksızın Aktif olarak listeliyor, böylece kendi programınıza göre geçiş yapabilirsiniz. Her ikisinde de hız limitleri aynıdır.

Beş bozucu değişiklik

Her biri, 4.5'te çalışan bir gövde için Haiku 5.5'te 400 hatası döndürür. Haiku 5.5 geçiş rehberi hepsini listeler.

1. budget_tokens ile manuel düşünme

Haiku 5.5 yalnızca uyarlanabilir düşünme çalıştırır. Sabit bir bütçe reddedilir.

// Önce (Haiku 4.5)
{
  "model": "claude-haiku-4-5-20251001",
  "max_tokens": 16000,
  "thinking": { "type": "enabled", "budget_tokens": 8000 },
  "messages": [{ "role": "user", "content": "Classify this ticket." }]
}

// Sonra (Haiku 5.5)
{
  "model": "claude-haiku-5-5",
  "max_tokens": 16000,
  "thinking": { "type": "adaptive" },
  "output_config": { "effort": "medium" },
  "messages": [{ "role": "user", "content": "Classify this ticket." }]
}

Çaba artık kaldıraçtır: 4.5 küçük bir bütçe kullandığı yerlerde, daha düşük bir çaba seçin. Hala thinking: {"type": "disabled"} gönderebilirsiniz, ancak yalnızca high çaba veya altında; xhigh veya max seviyesinde bu da bir 400 hatasıdır.

2. Örnekleme parametreleri

temperature, top_p ve top_k değerlerini kaldırın. Kabul edilen tek değerler temperature: 1 ve top_p: 0.99'dur. top_p: 1, herhangi bir top_k ve temperature ile top_p'yi birlikte göndermek dahil olmak üzere diğer tüm değerler 400 hatasıdır.

// Önce (Haiku 4.5)
{ "model": "claude-haiku-4-5-20251001", "max_tokens": 1024,
  "temperature": 0.2, "top_k": 40,
  "messages": [{ "role": "user", "content": "Extract the order ID." }] }

// Sonra (Haiku 5.5)
{ "model": "claude-haiku-5-5", "max_tokens": 1024,
  "messages": [{ "role": "user", "content": "Extract the order ID." }] }

Tutarlı çıktı için düşük sıcaklık kullandıysanız, bu niyeti istemin içine taşıyın.

3. Asistan ön doldurma

Modelin devam etmesi için son bir asistan sırası, düşünme kapalı olsa bile reddedilir. messages dizisini bir kullanıcı sırasıyla bitirin.

// Önce (Haiku 4.5)
{ "model": "claude-haiku-4-5-20251001", "max_tokens": 1024,
  "messages": [
    { "role": "user", "content": "Return the sentiment as JSON." },
    { "role": "assistant", "content": "{\"sentiment\": \"" }
  ] }

// Sonra (Haiku 5.5)
{ "model": "claude-haiku-5-5", "max_tokens": 1024,
  "system": "Reply with only a JSON object. No preamble.",
  "messages": [
    { "role": "user", "content": "Return the sentiment as JSON." }
  ] }

Katı formatlar için, geçiş rehberi yapılandırılmış çıktılara veya sınıflandırma için enum alanlarına sahip bir araca işaret eder.

4. Bilgisayar kullanımı: computer_20250124'ten computer_toolset_20260801'e

Claude API ve Google Cloud'da, Haiku 5.5 bilgisayar kullanımını yalnızca yeni araç seti aracılığıyla destekler. computer-use-2025-01-24 beta başlığını ve eğer gönderiyorsanız fine-grained-tool-streaming-2025-05-14 başlığını bırakın, çünkü bir araç seti ile birlikte 400 hatası döndürür.

// Önce (Haiku 4.5, başlık anthropic-beta: computer-use-2025-01-24)
{ "model": "claude-haiku-4-5-20251001", "max_tokens": 4096,
  "tools": [{ "type": "computer_20250124", "name": "computer",
              "display_width_px": 1280, "display_height_px": 800 }],
  "messages": [{ "role": "user", "content": "Open the settings page." }] }

// Sonra (Haiku 5.5, beta başlığı yok)
{ "model": "claude-haiku-5-5", "max_tokens": 4096,
  "tools": [{ "type": "computer_toolset_20260801" }],
  "messages": [{ "role": "user", "content": "Open the settings page." }] }

Aracı döngünüz de değişir: input.action yerine her bir tool_use bloğunun name ve toolset_name üzerine gönderim yapın ve sonuçlarda toolset_namei tekrarlayın. Haiku 5.5 ayrıca, Haiku 4.5'in desteklemediği tarayıcı kullanım aracını (browser_toolset_20260801) da edinir. Daha geniş resim için Claude Kod bilgisayar kullanımı bölümüne bakın.

5. Bir düşünme bloğundan önceki önceki dönüşleri düzenleme

Bir Haiku 5.5 düşünme bloğu, yalnızca ondan önce gönderilen her şey değişmeden kaldığı sürece geçerli kalır. system, tools veya önceki bir mesajı değiştirip bloğu geri gönderirseniz, 400 hatası alırsınız. Haiku 4.5 bu kontrolü asla çalıştırmadı. Burada, 1. dönüş "system": "You are a billing agent." gönderdi ve 2. dönüş onu düzenledi.

// Önce: düzenlenmiş sistem + tekrar oynatılan düşünme bloğu = 400
{ "model": "claude-haiku-5-5", "max_tokens": 4096,
  "system": "You are a billing agent. Be brief.",
  "messages": [
    { "role": "user", "content": "Why was I charged twice?" },
    { "role": "assistant", "content": [
      { "type": "thinking", "thinking": "", "signature": "<from turn 1>" },
      { "type": "text", "text": "Checking." } ] },
    { "role": "user", "content": "Order 4412." }
  ] }

// Sonra: önceki dönüşler değişmedi, yeni talimat eklendi
{ "model": "claude-haiku-5-5", "max_tokens": 4096,
  "system": "You are a billing agent.",
  "messages": [
    { "role": "user", "content": "Why was I charged twice?" },
    { "role": "assistant", "content": [
      { "type": "thinking", "thinking": "", "signature": "<from turn 1>" },
      { "type": "text", "text": "Checking." } ] },
    { "role": "user", "content": "Order 4412. Be brief." }
  ] }

31 Ağustos 2026, 00:00 UTC'den önce oluşturulan hesaplarda, hata yalnızca thinking.block_binding.prefix_mismatch_behavior ayarını yapan isteklerde görünür.

Hata vermeyecek sessiz değişiklikler

• Varsayılan olarak boş düşünme alanı. Her thinking bloğu, boş bir thinking alanı ve yalnızca bir signature ile döner. Haiku 4.5 özetlenmiş düşünmeyi döndürüyordu. Eğer bunu günlüğe kaydeder veya gösterirseniz thinking: {"type": "adaptive", "display": "summarized"} olarak ayarlayın.
• Yanıtlar düşünmeyle başlayabilir. Uyarlanabilir düşünme, siz ayarlamasanız bile açıktır, bu nedenle içerik bloklarını dizine göre değil, typea göre seçin.
• Yaklaşık %30 daha fazla token. Yeni tokenleştirici aynı metni yaklaşık %30 daha fazla token olarak sayar. İstemleri yeniden sayın ve düşünme tokenlarının max_tokensa dahil olduğunu unutmayın, bu nedenle küçük bir limit, herhangi bir metinden önce stop_reason: "max_tokens" ile durabilir.
• Zorunlu tool_choice düşünmeyi atlar. any veya adlandırılmış bir araç hala çalışır, ancak yanıt araç çağrısı ile başlar ve thinking bloğu içermez. Önce akıl yürütmesini istiyorsanız tool_choice: {"type": "auto"} kullanın ve modele aracı ne zaman çağıracağını bildirin.
• Yeni retler, geri dönüş yok. Haiku 5.5, stop_reason: "refusal" döndürebilen güvenlik sınıflandırıcıları (siber, sınır_llm, biyo, genel_zararlar) çalıştırır. Sunucu tarafı bir geri dönüş yoktur ve yeniden deneme genellikle tekrar reddeder.
• Öncelik Katmanı kaldırıldı. Haiku 4.5'te bir Öncelik Katmanı taahhüdünüz varsa, kapasiteyi ayrı olarak planlayın.
• Düşünme blokları hesaba bağlıdır. Yalnızca onları oluşturan hesapta veya bağlantılı bir hesapta çalışırlar. Depolanan konuşmaları başka bir hesap üzerinden yeniden oynatmak bu akıl yürütmeyi kaybettirir.
• Daha ucuz önbelleğe alma daha erken başlar. Minimum önbelleğe alınabilir istem 4.096 tokenden 512 tokene düşer, bu nedenle 4.5'te asla önbelleğe alınmayan kısa sistem istemleri artık önbelleğe alınır.

Neler İyileşti

Bunlar, Haiku 5.5'in maksimum çaba seviyesindeki Anthropic tarafından bildirilen rakamlardır; Artificial Analysis, GDPval-AA ve AA-Briefcase'i bağımsız olarak yürüttü.

Haiku 4.5'in Terminal-Bench çalıştırması, sabit 63.999 tokenlık bir düşünme bütçesi kullandı. Varsayılan medium çaba seviyesinde, Haiku 5.5 GDPval-AA'da 1277 puan alarak 4.5'in hala oldukça üzerinde kaldı. Box, Haiku 4.5'ten yaklaşık yarı gecikmeyle 11 puan daha yüksek skorlar bildirdi. Tam tablolar Claude Haiku 5.5 karşılaştırmaları bölümündedir.

Anthropic, Sonnet 5.5 ve Opus 5.5'i karmaşık aracılı kodlama için daha iyi seçenekler olarak konumlandırmaya devam ediyor. Haiku 5.5 sınıflandırma, veri çıkarma, özetleme, sıkıştırma, alt aracılar ve tarayıcı kullanımını hedefler.

Maliyet açısından, Anthropic, Haiku 5.5'in ortalama olarak yaklaşık %75 daha ucuz çalıştığını belirtiyor. Bu rakam, 100 bin tokene kadar %90 daha düşük fiyatları ve bunun üzerindeki %50 daha düşük fiyatları bir araya getirir ve yeni tokenleştiriciden kaynaklanan ek tokenları zaten telafi eder. Araç kullanımı sistem istemi de auto araç seçimiyle 496 tokenden 286 tokene düştü. Çalışan örneklere Claude Haiku 5.5 fiyatlandırması bölümünden ulaşabilirsiniz.

Apidog'da geçişi test edin

Apidog'da, https://api.anthropic.com/v1/messages adresine üç kaydedilmiş istekle tek bir proje oluşturun:

1. Temel: mevcut Haiku 4.5 gövdeniz. Durumu 200 olarak doğrulayın.
2. Eski gövde, yeni model: yalnızca modeli claude-haiku-5-5 olarak değiştirin. Durumu 400 olarak doğrulayın. Karşılaştığınız her bozucu değişiklik için bir kopya saklayın.
3. Geçiş yapıldı: düzeltilmiş gövde. Durumu 200, reddetme veya max_tokens olmayan bir stop_reason ve type ile bulunan bir metin bloğu olarak doğrulayın.

ANTHROPIC_API_KEYi bir ortam değişkeni olarak saklayın ve anthropic-version: 2023-06-01 ile x-api-key başlığında {{ANTHROPIC_API_KEY}} olarak referans verin. Tokenleştirici değişikliğini kendi istemlerinizde görmek için temel ve geçiş yapılmış istekler arasındaki usage.input_tokensu karşılaştırın. Bu seti bir test senaryosu olarak kaydedin ve temperatureı yeniden tanıtan bir ekip arkadaşı üretim yerine çalıştırmayı başarısız kılar. İstek temelleri Claude Haiku 5.5 API nasıl kullanılır bölümündedir.

Claude Code'da çalışıyorsanız, /claude-api migrate this project to claude-haiku-5-5 komutu model kimliği değişimini ve parametre düzeltmelerini uygular, ardından size bir kontrol listesi verir. haiku takma adının yalnızca Anthropic API'sinde Haiku 5.5'e çözümlendiğini unutmayın; Claude Code'da Claude Haiku 5.5 bölümüne bakın.

Sıkça Sorulan Sorular

Claude Haiku 4.5 kullanımdan kaldırıldı mı? Hayır. Herhangi bir kullanımdan kaldırma tarihi olmaksızın Aktif olarak listelenmiştir ve kullanımdan kaldırılması 15 Ekim 2026'dan önce değildir.

Haiku 4.5 isteğim neden Haiku 5.5'te 400 hatası döndürüyor? budget_tokens, temperature/top_p/top_k, bir asistan ön doldurma, computer_20250124 veya bir düşünme bloğundan önceki önceki dönüşlerde yapılan düzenlemeler olup olmadığını kontrol edin. Bunlar beş bozucu değişikliktir.

Uzun istemler için Haiku 5.5, Haiku 4.5'ten daha mı ucuz? Evet. 100 bin tokenden fazla olduğunda milyon başına 0,50$/2,50$ maliyetindedir, bu da Haiku 4.5'in 1$/5$ maliyetinin yarısıdır. Haiku 4.5, 200 bin tokendan fazla istemi hiçbir şekilde kabul edemez.

Her şeyi Haiku 5.5'e geçirmeli miyim? Sınıflandırma, veri çıkarma ve alt aracı çalışmaları için önce test edin, sonra geçiş yapın. Haiku 5.5 vs GPT-6 Luna bölümünde en yakın rakibiyle karşılaştırın.

Sonraki Adım

Haiku 4.5 isteğinizi Haiku 5.5 ikizinin yanına kaydedin, 400 hatasını onaylayın, düzeltin ve geçiş yapılmış istek başarılı olduğunda trafiği yönlendirin. Bu test çiftini oluşturmak için Apidog'u indirin.