Claude Fable 5.1 API'si Nasıl Kullanılır

Hızlı özet: CometAPI’de Claude Fable 5.1 API’sini kullanmak için bir API anahtarı hazırlayın, model kimliğini claude-fable-5-1 olarak ayarlayın ve daha uzun bir iş akışı kurmadan önce küçük bir isteği doğrulayın. Bu rehber erişim, efor, akış (streaming), araçlar, önbellekleme, geçiş (migrasyon) ve üretim kontrollerini kapsar. Yaygınlaştırmayı yalnızca bir model dizesini değiştirmekten daha fazlası olarak ele alın: rota uyumluluğunu teyit edin, çıktıları doğrulayın ve kullanım genişletmeden önce kabul edilen görev kalitesi, gecikme ve maliyeti ölçün.

Öne Çıkanlar

• Önce tek bir isteği çalıştırın: kimlik bilgilerini, model erişimini, seçilen uç noktayı ve hassas olmayan test verisiyle kullanılabilir bir yanıtı doğrulayın.
• Eforu bilinçli seçin: yüksek ile başlayın, sonra her istekte maksimum efor kullanmak yerine temsili görevlerde diğer ayarları karşılaştırın. Claude Code varsayılanı High’tır. Claude Cowork / Claude.ai varsayılanı Medium’dur.
• Geçiş davranışını gözden geçirin: zorunlu araç seçimi reddedilir; gerekli iş akışı adımlarını ve araç-argüman doğrulamasını uygulama kodunda tutun.
• Tüm iş akışını ölçün: önbellek kullanımı, token maliyeti, gecikme, retler, geri düşüş davranışı ve nihai sonucun kabul kriterlerinizi geçip geçmediğini takip edin.

Arka plan için CometAPI’nin önceki Fable 5.1 takipçisi ve Fable 5 API eğitimi bölümlerine bakın. Bu makale mevcut entegrasyon iş akışına odaklanır.

Claude Fable 5.1 Nedir?

Claude Fable 5.1, iddialı kodlama, çok adımlı araştırma, bilgisayar kullanımı ve belge ağırlıklı profesyonel iş akışları için Anthropic’in genel kullanıma açık en yetenekli modelidir. Anthropic, çoğu iş yüküne Claude Opus 5 ile başlamayı ve yüksek eforlu Opus değerlendirmeleri hâlâ yetersiz kaldığında Fable 5.1’e yükseltmeyi önerir.

Ayrım operasyoneldir: Fable 5.1, bağımlı adımlar boyunca çalışmayı sürdürmek, başarısız araç çağrılarından sonra toparlanmak, sonuçları doğrulamak ve uzun çalışmalarda ilerleme raporlamak üzere tasarlanmıştır. Bu, tamamlanma oranlarını iyileştirebilir; ancak maliyet, gecikme ve gözlemlenebilirliği devreye alımın merkezine yerleştirir.

Claude Fable 5.1 API Özellikleri

Resmî genel bakış 1M bağlam penceresi ve 128K azami çıktıyı doğrular. Uyarlamalı düşünme her zaman aktiftir; akıl yürütme derinliği geleneksel düşünme-token bütçesi yerine eforla kontrol edilir.

Claude Fable 5.1 API: Resmî Kıyaslama Performansı

Kısa kıyaslama özeti, makalenin ana amacı uygulama olduğu için kasıtlıdır. Aşağıdaki sonuçlar, API priminin en çok nerede önemli olabileceğini gösterir.

Anthropic’in resmî Claude Fable 5.1 kıyaslama karşılaştırması

Bu setin en büyük nesil sıçraması Terminal-Bench-Science’ta: 52.6% ve 24.7%. AutomationBench 17.1%’den 31.4%’e yükselirken, Terminal-Bench 4.0 55.8%’e iyileşir. Sonuç, araştırma ajanları, uzun süreli kodlama ve iş otomasyonunda Fable 5.1’i test etmek için güçlü bir gerekçe sunar—kısa her isteği en pahalı modele yönlendirmek için değil.

Claude Fable 5 API’den Ne Değişti?

Üç Kırıcı Değişiklik

Zorunlu Araç Kullanımı Artık Desteklenmiyor

Claude Fable 5.1, herhangi bir aracı veya adı verilen belirli bir aracı zorlayan tool_choice değerlerini reddeder ve 400 invalid-request hatası döndürür. Otomatik seçimi kullanın, doğrulama için sıkı şemalar veya yapılandırılmış çıktılar tercih edin ve zorunlu iş akışı adımlarını model araç çağrısını zorlamak yerine uygulama orkestrasyonunda uygulayın.

Önceki Modeller Fable 5.1 Düşünme Bloklarını Okuyamaz

Düşünme uyumluluğu tek yönlüdür: Fable 5.1, önceki uyumlu Claude modellerince oluşturulan düşünme bloklarını tüketebilir, ancak önceki modeller Fable 5.1 tarafından oluşturulan blokları okuyamaz. Daha önceki bir modele geri dönen bir yönlendirici veya geri düşüş bu blokları çıkarabilir, bu yüzden entegrasyonlar model geçişlerini günlüğe almalı ve geri düşüş davranışını açıkça test etmelidir.

Önceki Turları Düzenlemek Korunan Düşünmeyi Geçersiz Kılar

Önceki bir sistem istemini, araç tanımını, mesajı veya başvuru dosyası baytlarını değiştirmek daha sonraki düşünme bloklarını geçersiz kılabilir. Konuşma ön ekini eklemeli şekilde ele alın, geçmişi yeniden yazmak yerine konuşma ortasında talimatlar kullanın ve geçiş sırasında ön ek uyuşmazlığı dönüşümlerini izleyin.

Beş Ek API Yeteneği

Mesaj Başına Efor

Uygulamalar, istem önbelleğini geçersiz kılmadan bir konuşma sırasında eforu değiştirebilir. Bu beta yeteneği, bir iş akışının rutin takiplerde eforu düşürmesine ve zor planlama, hata ayıklama veya doğrulama turlarında artırmasına olanak tanır.

Tur Kapsamlı Sistem Mesajları

Beta sistem mesajı bir tura uygulanabilir ve bir sonraki kullanıcı mesajından sonra işlenmeyi durdururken geçmişte değişmeden kalır. Bu, araç döngülerinde geçici talimatlar için yararlıdır çünkü hem istem önbelleği eşleşmesini korur hem de daha sonraki düşünme bloklarının geçerliliğini sağlar.

Araç Çağrıları Arasında Okunabilir İlerleme Güncellemeleri

Beta ilerleme gösterimi seçeneğiyle, seçili düşünme blokları, uygulamanın kullanıcıya gösterilebilecek kısa durum güncellemeleri taşıyabilir; özel akıl yürütme gizli kalır. Uzun süreli ajanlar bu güncellemeleri nihai yanıt değil, operasyonel durum olarak değerlendirmelidir.

Daha Düşük Önbellek Okuma Fiyatı

Önbellek okumaları milyon token başına $0.25’tir; bu, Fable 5 önbellek okuma oranının dörtte biridir. Bu, sabit bir önbelleğe alınmış ön eki tekrar tekrar kullanan uzun oturumların maliyetini anlamlı biçimde düşürebilir.

İçerik Kökeni (Provenance)

Üretilen metin Anthropic’in istatistiksel filigranını taşır; Files API üzerinden alınan desteklenen medya, imzalı C2PA Content Credentials içerebilir. Bu köken mekanizmaları istem token’ı eklemez veya istek biçimini değiştirmeyi gerektirmez.

Claude Fable 5.1 API’yı Kullanmak İçin Neye İhtiyacınız Var?

• Hesap ve API anahtarı: CometAPI’ye giriş yapın ve API anahtarı konsolunda bir anahtar oluşturun. Model erişimini ve hesabınızın kullanım bazlı faturalamaya hazır olduğunu test çağrıları göndermeden önce kontrol edin.
• Yerel çalışma zamanı: ilk HTTP örneği için curl içeren bir terminal kullanın. Python örnekleri için, izole bir ortamda Python ve pip hazırlayın, ardından seçtiğiniz örneğin kullandığı SDK’yı kurun.
• Seçili rota: CometAPI’de Claude Fable 5.1 API’si Messages ve Chat Completions formatları sunar. Uygun temel URL’yi ve istek formatını kullanın; yükleri karıştırmayın.
• Güvenli yapılandırma: COMETAPI_KEY değerini sürüm kontrolüne girmeyecek şekilde ayarlayın, model kimliği olarak claude-fable-5-1 kullanın ve ağınızın https://api.cometapi.com. adresine erişebildiğinden emin olun.
• Güvenli test ve kabul kontrolü: kısa ve hassas olmayan bir istemle başlayın. Yanıtın kullanılabilir içerik içerdiğini doğrulayın, kullanım ve tamamlanma durumunu inceleyin ve gerçek belgeler veya günlükleri göndermeden önce kuruluşunuzun veri işleme gereksinimlerini kontrol edin.

Claude Fable 5.1’e CometAPI Üzerinden Nasıl Erişilir?

CometAPI, Claude Fable 5.1’i Anthropic uyumlu Messages rotası ve OpenAI uyumlu Chat Completions rotası üzerinden sunar. Yerel efor, düşünme, önbellekleme ve Claude araç semantiğine ihtiyaç duyduğunuzda Messages’ı; uygulamanız zaten OpenAI SDK’sında standartlaştıysa Chat Completions’ı kullanın.

Adım 1: API anahtarını saklayın

export COMETAPI_KEY="your-cometapi-key"

$env:COMETAPI_KEY="your-cometapi-key"

Adım 2: İlk Messages isteğini yapın

curl https://api.cometapi.com/v1/messages \
  --header "Authorization: Bearer $COMETAPI_KEY" \
  --header "content-type: application/json" \
  --data '{
    "model": "claude-fable-5-1",
    "max_tokens": 2048,
    "messages": [{
      "role": "user",
      "content": "Review this deployment architecture and list the three highest-risk failure modes."
    }]
  }'

Adım 3: Anthropic Python SDK’sını kullanın

pip install anthropic

import os
import anthropic

client = anthropic.Anthropic(
    api_key=os.environ["COMETAPI_KEY"],
    base_url="https://api.cometapi.com",
)

response = client.messages.create(
    model="claude-fable-5-1",
    max_tokens=4096,
    messages=[{
        "role": "user",
        "content": "Find the root cause of this test failure and propose a verified patch.",
    }],
)

print(response.content[0].text)

Adım 4: OpenAI Python SDK’sını kullanın

pip install openai

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["COMETAPI_KEY"],
    base_url="https://api.cometapi.com/v1",
)

response = client.chat.completions.create(
    model="claude-fable-5-1",
    messages=[{
        "role": "user",
        "content": "Design a migration plan for this service.",
    }],
)

print(response.choices[0].message.content)

Claude Fable 5.1 API’de akıl yürütme nasıl çalışır?

Önceki Modeller Claude Fable 5.1 Düşünme Bloklarını Okuyamaz

Fable 5.1 tarafından üretilen düşünme blokları, önceki Claude modelleriyle geriye dönük uyumlu değildir. Bir iş akışı konuşma ortasında modeli değiştirirse, uyumsuz düşünme bloklarını kaldırın veya yalnızca bir sonraki istek için gereken kullanıcıya görünür mesajlar ve araç sonuçlarını koruyarak yeni bir dal başlatın.

Önceki Turları Düzenlemek Korunan Düşünmeyi Geçersiz Kılar

Korunan bir düşünme bloğu, önceki konuşma durumuna kriptografik olarak bağlanır. Önceki sistem istemini, araç tanımını, kullanıcı mesajını, asistan yanıtını veya araç sonucunu değiştirmek bu bağı bozabilir ve düşünme geçmişi hatasını tetikleyebilir. Yeniden oynatılan ön eki bayt bazında sabit tutun ve eski turları yeniden yazmak yerine yeni turlar ekleyin.

Turlar Arasında Korunan Düşünme

Konuşma ön eki değişmeden kaldığında, korunan düşünme daha sonraki turlara faydalı akıl yürütme durumunu taşıyabilir. Düşünme bloklarını özgün mesaj sırasıyla saklayın, yalnızca uyumlu bir modele yeniden oynatın ve bir geçmiş düzenlemesini mevcut konuşmayı mutasyona uğratmak yerine yeni bir konuşma dalı olarak ele alın.

Efor ile Akıl Yürütmeyi Kontrol Edin

Zor üretim işlerinde yüksek eforla başlayın; ardından rutin turlarda daha düşük ayarları test edin ve yalnızca kabul edilen görev kalitesini maliyet ve gecikmeyi haklı çıkaracak kadar artırdığı durumlarda xhigh veya max kullanın. Efor turlar arasında değişebildiği için bir konuşmanın tamamı aynı akıl yürütme düzeyine bağlı kalmak zorunda değildir.

Fable 5.1, uyarlamalı düşünmeyi tek düşünme modu olarak kullanır. Yüksek eforla başlayın; ardından rutin işler için daha düşük ayarları ölçün ve ek yetenek maliyet ve gecikmeyi haklı çıkardığında xhigh veya max’ı değerlendirin.

response = client.messages.create(
    model="claude-fable-5-1",
    max_tokens=8192,
    output_config={"effort": "high"},
    messages=[{
        "role": "user",
        "content": "Audit this repository migration plan.",
    }],
)

Claude Fable 5.1 API: Uzun Yanıtları Akıtın, Araçları ve İstem Önbelleğini Kullanın

Şu denetimleri birlikte yapılandırın: akıl yürütme eforu, akış (streaming), araç yürütme, istem önbelleği ve güvenlik önlemleri ile elde tutulan verilerin işlenmesi. Her biri uzun soluklu bir isteğin nasıl gözlemlendiğini, doğrulandığını ve işletildiğini etkiler.

Uzun Yanıtları Akıtın

Akış, uzun ve yüksek eforlu görevler için daha güvenli varsayılandır; uygulama büyük bir yanıtın tamamlanmasını beklemeden çıktı almaya başlar.

with client.messages.stream(
    model="claude-fable-5-1",
    max_tokens=8192,
    output_config={"effort": "high"},
    messages=[{
        "role": "user",
        "content": "Analyze these logs and produce a remediation plan.",
    }],
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

Zorunlu Araç Seçimi Olmadan Araçları Kullanın

Fable 5.1, tool_choice kullanılarak herhangi bir araç ya da adı verilen bir aracın zorla seçilmesini reddeder. Otomatik seçimi kullanın, sıkı şemalar uygulayın, araç argümanlarını uygulama kodunda doğrulayın ve zorunlu iş akışı sıralamasını modelin dışında kontrol edin. Bir iş akışı belirli bir aracın çalıştırılmasını gerektiriyorsa, bunu tool_choice üzerinden zorlamaya güvenmeyin. Uygulamanın o aracı çağırmasını sağlayın veya gerekli adımı orkestrasyon kodunda uygulayın.

tools = [{
    "name": "search_incidents",
    "description": "Search recent production incidents",
    "input_schema": {
        "type": "object",
        "properties": {
            "service": {"type": "string"},
            "days": {"type": "integer"},
        },
        "required": ["service", "days"],
    },
}]

response = client.messages.create(
    model="claude-fable-5-1",
    max_tokens=4096,
    tools=tools,
    tool_choice={"type": "auto"},
    messages=[{
        "role": "user",
        "content": "Review checkout incidents from the last 30 days.",
    }],
)

Uzun Bağlamlar için İstem Önbelleğini Kullanın

Anthropic, önbellek okumalarını milyon token başına $0.25 olarak listeler; bu, Fable 5 oranının dörtte biridir. Sabit sistem talimatlarını, araç şemalarını ve büyük referans materyalini dinamik kullanıcı içeriğinin önüne yerleştirin, ardından kullanım meta verilerinde önbellek isabetlerini doğrulayın.

messages = [{
    "role": "user",
    "content": [
        {
            "type": "text",
            "text": large_reference_document,
            "cache_control": {"type": "ephemeral"},
        },
        {
            "type": "text",
            "text": "Identify obligations that changed in this revision.",
        },
    ],
}]

Güvenlik Önlemleri ve Veri Saklama ile Başa Çıkın

Anthropic, birçok bayraklanan siber güvenlik ve biyoloji isteğinin daha az yetenekli modellere yönlendirildiğini belirtir. Bir reddi veya geri düşüşü bir uygulama durumu olarak ele alın: durdurma nedenini kaydedin, uygun bir kullanıcı mesajı gösterin ve politika izin verdiğinde onaylı bir alternatife yönlendirin.

Fable ayrıca güvenlik izlemesi için varsayılan olarak 30 günlük veri saklama gerektirir. Geçerli bir isteği yalnızca bir API biçim sorununa indirgemeden önce kurumsal uygunluğu ve saklama ayarlarını doğrulayın.

Fable 5.1 vs Opus 5 vs Sonnet 5

Seçim sonucu: rutin trafiği Sonnet 5’te başlatın, karmaşık genel işler için Opus 5’i kullanın ve yalnızca en zor veya tekrar tekrar başarısız olan görevleri Fable 5.1’e yükseltin. Bu, Anthropic’in rehberliğine uyar ve her isteğin varsayılan maliyetini en pahalı akıl yürütmeye dönüştürmeyi önler.

CometAPI Üzerinden Fiyatlandırma

Canlı CometAPI model sayfası mevcut rota erişilebilirliği ve fiyatlandırmanın hakiki kaynağıdır. 100,000 önbelleksiz girdi token’ı ve 10,000 çıktı token’ı olan bir istek için basit CometAPI tahmini $1.20’dir; gerçek maliyet önbellekleme, akıl yürütme, parti davranışı ve yönlendirmeyle değişebilir. Fiyatlar değişebilir; üretim bütçelemesinden önce canlı model sayfasını kontrol edin.

Fable 5’ten Geçiş Kontrol Listesi

1. Model kimliğini claude-fable-5’ten claude-fable-5-1’e değiştirin.
2. tool_choice any ve adlandırılmış araç zorlamasını kaldırın; auto kullanın.
3. Eski düşünme-bütçesi varsayımlarını output_config.effort ile değiştirin.
4. Değerlendirmeye yüksek eforla başlayın, ardından gerçek görevlere göre ince ayar yapın.
5. Korunan düşünme blokları içeriyorsa geçmişleri eklemeli tutun.
6. Uzun ve yüksek eforlu çalıştırmalar için max_tokens artırın.
7. Kullanım meta verilerinden önbellek isabetlerini doğrulayın.
8. Reddetmeleri ve geri düşüşleri açık durumlar olarak ele alın.
9. Üretim izlerini yeniden oynatın ve kabul oranı, gecikme ve maliyeti karşılaştırın.

En güvenli geçiş stratejisi: geçmişleri eklemeli tutun. Fable 5.1, düşünme bloklarını turlar arasında koruyabilir, ancak yeniden oynatılan düşünme blokları önceki konuşma durumuna bağlıdır; önceki sistem istemlerini, araçları veya mesajları değiştirmek bu bağı geçersiz kılabilir.

Yaygın API Hataları

Araç çağrıları değiştikten sonra 400 hatası

Muhtemel neden: tool_choice ile herhangi bir araç veya adlandırılmış araç zorlaması. Auto kullanın ve gerekli sıralamayı uygulama mantığında zorlayın.

claude-fable-5.1 çalışmıyor

Kanonik kimlik tirelidir: claude-fable-5-1.

Çıktı beklenenden erken bitiyor

effort, modelin ne kadar akıl yürüttüğünü kontrol eder; max_tokens, yanıt token bütçesini sınırlar. Daha yüksek efor daha fazla çıktı bütçesi gerektirebilir, bu nedenle üretim uygulamaları her ikisini de bağımsız olarak ayarlamalıdır. Gerekliyse max_tokens değerini artırın ve uzun yanıtları akıtın.

İstem önbelleği hiç isabet etmiyor

Önbelleğe alınan ön eki bayt bazında sabit tutun; zaman damgaları, yeniden sıralanan araçlar ve değişen sistem mesajları yeniden kullanımı engeller.

HTTP başarılı yanıt normal bir cevap içermiyor

Her reddi bir taşıma (transport) hatası olarak ele almak yerine stop_reason ve geri düşüş meta verilerini inceleyin.

Geçmişi yeniden oynatmak düşünme hatası üretiyor

Korunan Fable 5.1 düşünme bloklarından önceki turları düzenlemeyin. Eklemeli geçmiş kullanın veya mevcut geçiş denetimlerini uygulayın.

Claude Fable 5.1 API’sini Üretimde Nasıl Kullanmalısınız?

İstek yönlendirme, model yürütme, araç yürütme, doğrulama ve değerlendirmeyi birbirinden ayırın. Model kimliğini, eforu, gecikmeyi, token kullanımını, önbellek kullanımını, durdurma nedenini, geri düşüş davranışını ve nihai görev başarısını kaydedin.

Fable 5.1’i depo genelinde geçişler, zor hata ayıklama, uzun süreli ajanlar, derin araştırma, büyük belge sentezi ve daha ucuz modellerin tekrar tekrar başarısız olduğu yüksek değerli görevler için kullanın. Özetler, sınıflandırma, çıkarım ve kısa müşteri hizmetleri yanıtları için varsayılan yapmaktan kaçının.

Örnek: Bir Ödeme (Checkout) Olayını İnceleyin

Bir ekip, anonimize edilmiş ödeme hatalarını, yakın tarihli dağıtım farklarını ve ilgili runbook’ları sağlayabilir. Uygulama ilgili olay kayıtlarını getirir, ardından modelden olası nedenleri sıralamasını ve her hipotezi kanıta bağlamasını ister. Bir mühendis önerilen tanılama adımlarını gözden geçirir ve sentetik işlemler kullanan bir alan (sandbox) içinde bir testi onaylar. Kabul eşiği; yeniden üretilebilir davranış, izlenebilir kanıt ve geçen regresyon kontrolleridir; herhangi bir üretim iyileştirmesi ayrı bir insan onayı gerektirir.

Örnek: İşletme Gereksinimlerindeki Değişiklikleri Analiz Edin

Bir ekip onaylı bir işletme kılavuzunu, destekleyici politikaları ve revize edilmiş bir taslağı sağlayabilir. Değişmeyen referans materyali sabit bağlam olarak tutun, ardından modelden değişen yükümlülükleri, sorumlu ekipleri, son tarihleri ve istisnaları karşılaştırmasını isteyin. Önerilen her bulgu her iki sürümde de ilgili pasajlara referans vermeli ve açık değişiklikleri belirsiz yorumlardan ayırmalıdır. Kabul eşiği, her bildirilen değişikliğin alıntılanan kanıtla doğrulanmasıdır; prosedürleri güncellemeden veya etkilenen ekipleri bilgilendirmeden önce bir gözden geçirici onayı gerekir.

Sonuç

Claude Fable 5.1, yalnızca bir model dizesi güncellemesi değildir. Zorunlu araç davranışı, düşünme geçmişi kuralları, efor kontrolleri, önbellek ekonomisi ve uzun süreli ilerleme özellikleri bilinçli bir geçiş gerektirir.

En etkili yaygınlaştırma, rutin hacim için Claude Sonnet 5’i, karmaşık varsayılan trafik için Claude Opus 5’i ve ölçülü bir yetenek artışı olarak Claude Fable 5.1’i kullanır. Kabul edilen görev tamamlanması toplam maliyet ve gecikmeyi haklı çıkaracak kadar iyileştiğinde yükseltin.