Claude Sonnet 5.5 API Kullanımı: İlk Çağrı, Çaba, Düşünme, Araçlar ve Akış

Claude Sonnet 5.5 API'sini kullanmak için, https://api.anthropic.com/v1/messages adresine "model": "claude-sonnet-5-5" ile, x-api-key başlığında anahtarınızla ve anthropic-version: 2023-06-01 ile bir POST isteği gönderin. Milyon girdi token'ı başına 2 dolar, milyon çıktı token'ı başına 10 dolar maliyeti vardır, 1 milyon token'a kadar bağlam okur, 128 bin token'a kadar yazar, varsayılan olarak uyarlanabilir düşünme çalıştırır ve varsayılan çaba seviyesi high'dır.

Anthropic, Sonnet 5.5'i 28 Eylül 2026'da yayınladı (Claude Sonnet 5.5 nedir özellikleri ve karşılaştırmaları kapsar). Bu kılavuz, curl, Python ve TypeScript'te ilk çağrıyı, ardından çabayı, düşünmeyi, araçları, akışı, retleri ve oran sınırlamalarını anlatır. Sonnet 5 kodunu mu taşıyorsunuz? Sonnet 5.5 vs Sonnet 5 kılavuzu, her önemli değişikliği önceki/sonraki JSON ile birlikte içerir. Aşağıdaki her isteği Apidog'dan gönderebilir ve iddialarla birlikte kaydedilmiş bir test olarak saklayabilirsiniz.

Claude Sonnet 5.5 API'sine bir bakış

Kaynaklar: Sonnet 5.5 model sayfası ve geçiş kılavuzu.

Claude Sonnet 5.5 API örneği: ilk çağrınız

Bir anahtar oluşturun (Anthropic API anahtar kılavuzu bunu adım adım anlatır) ve sabit kodlamak yerine ANTHROPIC_API_KEY olarak dışa aktarın. Ardından şunu gönderin:

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 4096,
    "output_config": {"effort": "medium"},
    "messages": [{"role": "user", "content": "Explain idempotency keys in two sentences."}]
  }'

Python SDK'sı ANTHROPIC_API_KEY'i ortamdan okur:

import anthropic

client = anthropic.Anthropic()
response = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=4096,
    output_config={"effort": "medium"},
    messages=[{"role": "user", "content": "Explain idempotency keys in two sentences."}],
)
print(response.stop_reason)
for block in response.content:
    if block.type == "text":
        print(block.text)

TypeScript aynı şekilde çalışır:

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic();
const response = await client.messages.create({
  model: "claude-sonnet-5-5",
  max_tokens: 4096,
  output_config: { effort: "medium" },
  messages: [{ role: "user", content: "Explain idempotency keys in two sentences." }],
});
for (const block of response.content) {
  if (block.type === "text") console.log(block.text);
}

İçerik bloklarını type'a göre okuyun. Düşünme varsayılan olarak açıktır, bu nedenle bir yanıt bir thinking bloğuyla başlayabilir ve content[0].text okuyan kod bozulur. Düşünme token'ları, metinleri gizli olsa bile çıktı olarak faturalandırılır ve max_tokens'a dahil edilir, bu nedenle beklediğiniz yanıttan daha fazla boşluk bırakın.

Bir çaba seviyesi seçin

output_config.effort içinde ayarlanan çaba, ana maliyet ve kalite kontrolünüzdür. Anthropic, Sonnet 5.5 için seviyeleri yeniden kalibre etti, bu nedenle bir Sonnet 5 ayarı geçersizdir; kendi değerlendirmeleriniz üzerinde yeni bir tarama yapın. İstem kılavuzu şu başlangıç noktalarını önermektedir:

Yayılım geniştir. Anthropic'in kendi Terminal-Bench 4.0 çalıştırmalarında, Sonnet 5.5, deneme başına 1.94$ karşılığında high seviyesinde %43.0 ve 12.54$ karşılığında max seviyesinde %70.6 puan aldı. Sonnet 5.5 fiyatlandırma dökümü istek başına maliyeti ayrıntılarıyla açıklar.

Üç davranış için plan yapın. medium seviyesinden itibaren model, bir selamlaşma bile olsa neredeyse her yanıttan önce düşünür ve onu daha az düşünmeye teşvik etmek güvenilir değildir: bunun yerine çabayı düşürün. low ve medium seviyelerinde, uzun etkileşimli görevlerde erken kontrol etme eğilimindedir. İstekler arasında üst düzey çabayı değiştirmek, istem önbelleğini geçersiz kılar. Konuşma ortasında seviyeleri değiştirmek ve önbelleği korumak için mesaj başına çaba kullanın (beta, başlık anthropic-beta: mid-conversation-output-config-2026-07-01): boş content ve yeni output_config.effort içeren bir role: "system" mesajı ekleyin.

Düşünmeyi kontrol etme: uyarlanabilir veya between_tools

thinking alanını atlarsanız Sonnet 5.5 uyarlanabilir düşünme çalıştırır. {"type": "disabled"}'ı 400 ile reddeder. Ön düşünmeyi kapatmak için en düşük ayar olan between_tools'u gönderin:

{
  "model": "claude-sonnet-5-5",
  "max_tokens": 16000,
  "thinking": {"type": "between_tools"},
  "output_config": {"effort": "high"},
  "messages": [{"role": "user", "content": "..."}]
}

Sonnet 5.5 between_tools için kurallar:

• Yalnızca düşük, orta veya yüksek seviyelerinde çalışır. xhigh veya maks seviyesinde 400 döndürür.
• Başka hiçbir alan almaz. display, budget_tokens veya block_binding eklemek 400 döndürür.
• Beta başlığına ihtiyaç duymaz ve her platformda çalışır.
• Ayarlandığında, konuşma ortasında çaba değiştirilemez.
• Bunu tanımlamayan SDK sürümleri tip denetiminde başarısız olur, bu nedenle SDK'nızı güncelleyin.

Uyarlanabilir düşünme altında, display düşünme bloklarının ne içerdiğini belirler. Varsayılan olan omitted, her thinking bloğunu boş bir thinking alanı ve bir signature ile döndürür. summarized okunabilir özetler döndürür. updates (beta, başlık thinking-display-updates-2026-08-18) yalnızca ilerleme güncellemelerini metin olarak döndürür.

İlerleme güncellemeleri, bir kullanıcı arayüzünü karıştırma olasılığı en yüksek değişikliktir. Sonnet 5.5, araç çağrıları arasında yazılan, bir veya iki cümleden uzun notları text yerine kendi thinking bloklarına yerleştirir. Varsayılan omitted altında bu bloklar boş olduğu için, adımlarını anlatan bir aracı arayüzü sessiz kalır. display: "updates" veya "summarized" ayarlayın ya da notları metinle döndüren between_tools'u çalıştırın. Her boş olmayan thinking bloğunu onu takip eden tool_use bloğundan önce işleyin. Yanıt metninde muhakeme istemek bir reasoning_extraction reddine davetiye çıkarır, bu nedenle bunun yerine bu blokları okuyun.

Zorunlu tool_choice olmadan araçları kullanın

Zorunlu araç kullanımı kaldırılmıştır. {"type": "any"} veya {"type": "tool", ...} şeklindeki bir tool_choice, token sayma uç noktasında da bu mesajla birlikte 400 döndürür:

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

auto gönderin, aracın girdisinin şemaya uyması için aracı strict: true olarak işaretleyin ve istemde modeli ne zaman çağıracağınızı belirtin:

{
  "model": "claude-sonnet-5-5",
  "max_tokens": 1024,
  "tools": [{
    "name": "get_weather",
    "description": "Get the current weather for a city",
    "input_schema": {
      "type": "object",
      "properties": {"location": {"type": "string"}},
      "required": ["location"],
      "additionalProperties": false
    },
    "strict": true
  }],
  "tool_choice": {"type": "auto"},
  "messages": [{"role": "user", "content": "What's the weather in Paris? Use the get_weather tool."}]
}

Bir istek en fazla 20 katı araç taşıyabilir ve katı şemalar her nesnede additionalProperties: false gerektirir. Amazon Bedrock'ta, Sonnet 5.5 için katı araçlar mevcut değildir: strict olmadan auto gönderin ve girdiyi kodunuzda doğrulayın.

İki döngü detayı önemlidir. Her thinking bloğunu, boş olanlar dahil, tool_use bloğuyla birlikte değiştirmeden geri geçirin. Ve Bash olarak tanımlanmış bir araç için bash gibi ara sıra durum kaymalarını bekleyin. İstem kılavuzu, açık eşleşmeleri kabul etmeyi veya tam adı belirten is_error: true ile bir tool_result döndürmeyi önermektedir.

Yanıt akışları

Gövdeye "stream": true ekleyin veya SDK'nın akış yardımcısını kullanın. Etkileşimli kodlama için istem kılavuzu, akışla birlikte 128.000 max_tokens önermektedir:

with client.messages.stream(
    model="claude-sonnet-5-5",
    max_tokens=128000,
    output_config={"effort": "medium"},
    messages=[{"role": "user", "content": "Review this diff for bugs: ..."}],
) as stream:
    for event in stream:
        if event.type == "content_block_delta" and event.delta.type == "text_delta":
            print(event.delta.text, end="", flush=True)
    final = stream.get_final_message()

Sunucu tarafından gönderilen olaylar message_start olarak gelir, ardından her blok için content_block_start, content_block_delta ve content_block_stop gelir, sonra message_delta (stop_reason taşıyan) ve message_stop. omitted altında, bir düşünme bloğu bir boş thinking_delta ve bir signature_delta akışını sağlar, sonra metin başlar. Bir ilerleme-güncelleme bloğu açılmadan önce birkaç saniyelik bir duraklama bekleyin.

stream.get_final_message() (TypeScript: stream.finalMessage()) imzalarıyla birlikte tam blokları yeniden oluşturur. Bu içeriği geçmişe asistanın sırası olarak, değiştirmeden ekleyin ve geçmişi yalnızca eklenebilir tutun. Sonnet 5.5, her düşünme bloğunu kendinden önceki konuşma üzerinde imzalar, bu nedenle 31 Ağustos 2026 (00:00 UTC) tarihinde veya sonrasında oluşturulan hesaplarda, önceki geçmişi düzenledikten sonra bir bloğu yeniden oynatmak 400 döndürür. Bloklar ayrıca onları üreten hesapla da ilişkilidir.

Retleri ve geri dönüşleri yönetme

Bir ret bir hata değildir. stop_reason: "refusal" ve category'si cyber, bio, frontier_llm, reasoning_extraction veya general_harms olan bir stop_details nesnesi ile HTTP 200 alırsınız, ayrıca bir explanation (açıklama) bulunur. Açıklamayı ayrıştırmak yerine görüntüleyin; çünkü ifade şekli kararlı değildir. content'i okumadan önce stop_reason'a göre dallanma yapın.

Sunucu tarafı geri dönüş isteğe bağlıdır. "fallbacks": "default" ve anthropic-beta: server-side-fallback-2026-07-01 başlığını (beta, yalnızca Claude API) ekleyin; API, Sonnet 5 üzerinde cyber ve frontier_llm reddedilenleri yeniden dener. Diğer üç kategori yeniden denenmez. Yanıtın model alanı, hizmet veren modelin adını belirtir ve bir fallback içerik bloğu devri işaretler.

Oran sınırlamaları

Sonnet 5.5'in Sonnet 5'inkinden ayrı kendi oran sınırlaması vardır. Oran sınırlamaları sayfası dört seviye listeler:

429 hata yönetimi ve geri çekilme için, oran sınırı aşıldı kılavuzuna bakın.

Apidog'da Claude Sonnet 5.5 API'sini test etme

Kaydedilmiş istekler, çaba karşılaştırmalarını ve akış hata ayıklamasını tekrarlanabilir hale getirir. Apidog'daki kurulum şöyledir:

1. Bir ortam oluşturun ve ANTHROPIC_API_KEY'i bir değişken olarak ekleyin. x-api-key başlığında, anthropic-version ve content-type'ın yanında {{ANTHROPIC_API_KEY}} olarak referans verin.
2. https://api.anthropic.com/v1/messages adresine bir POST isteği oluşturun, ilk çağrı gövdesini yapıştırın ve kaydedin.
3. Onaylar ekleyin: durum 200, $.stop_reason end_turn'e eşit, $.usage.output_tokens 0'dan büyük ve $.content[*].type text içeriyor. Bir ret artık sessizce geçmek yerine testi başarısız kılar.
4. İsteği "stream": true ile çoğaltın. Apidog, text/event-stream yanıtını olay olay gösterir, böylece boş thinking_delta'yı, signature_delta'yı ve metnin sırasıyla geldiğini izleyebilirsiniz.
5. Onu "model": "claude-sonnet-5" ile tekrar klonlayın ve çifti tek bir klasörde tutun: aynı istem, iki model, kullanım yan yana.

Daha geniş kalıplar için, LLM uygulamalarını test etme ve yapay zeka aracı API'lerini test etme konularına bakın.

SSS

Claude Sonnet 5.5 model kimliği nedir? Claude API, Google Cloud, Microsoft Foundry ve AWS üzerindeki Claude Platform'da tarih eki olmadan claude-sonnet-5-5. Amazon Bedrock'ta anthropic.claude-sonnet-5-5'tir.

Düşünmeyi tamamen kapatabilir miyim? Hayır. disabled 400 döndürür. between_tools en düşük ayardır: düşük, orta veya yüksek çaba seviyesinde ön düşünme yok.

Sonnet 5 isteğim neden Sonnet 5.5'te 400 döndürüyor? Önce thinking.type: "disabled" ve zorunlu bir tool_choice olup olmadığını kontrol edin. Sonnet 5.5 vs Sonnet 5 kılavuzu, beş önemli değişikliğin tamamını ve düzeltmelerini kapsar.

Ücretsiz bir Claude Sonnet 5.5 API'si var mı? Anthropic'in API'si ön ödemelidir ve hiçbir resmi sayfa ücretsiz bir kayıt kredisi listelemez. Bir Claude sohbet planı da API erişimi içermez. Ücretsiz API kılavuzu, kredi programlarını ve en ucuz ücretli yolu kapsar.

Sonraki adım

İlk çağrı isteğini medium seviyesinde gönderin, ardından high seviyesinde yeniden çalıştırın ve kendi iş yükünüzden bir istem üzerinde usage.output_tokens ile yanıt kalitesini karşılaştırın. Her iki çalıştırmayı da onaylarla kaydetmek için Apidog'u indirin. Terminalden çalışmayı tercih ediyorsanız, Claude Code'da Claude Sonnet 5.5'i inceleyin.