Claude Haiku 5.5 and Nano Banana 2.1 are now live on CometAPI →
technology/Badania CometAPI

Jak korzystać z interfejsu API Claude Sonnet 5.5

Dowiedz się, jak korzystać z Claude Sonnet 5.5 API z CometAPI przy użyciu cURL, Pythona i JavaScriptu. Poznaj Messages API, dostęp kompatybilny z OpenAI, streaming oraz vision.

CometAPI
Deon GoodwinZespół badań AI modeli i API
Zaktualizowano Oct 13, 2026 19 min czyt.
Jak korzystać z interfejsu API Claude Sonnet 5.5
Użyj tego wzorca

Wykonaj pierwsze wywołanie API.

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_COMETAPI_KEY",
    base_url="https://api.cometapi.com/v1",
)

response = client.chat.completions.create(
    model="gpt-5-mini",
    messages=[{"role": "user", "content": "Build this workflow."}],
)

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

TL;DR

Claude Sonnet 5.5 to szybki model do jasno zdefiniowanego kodowania, pracy z dokumentami i przepływów z użyciem narzędzi. Anthropic podaje ponad 30% szybsze generowanie niż Sonnet 5 przy tych samych standardowych stawkach tokenów. Zacznij od klucza CometAPI, identyfikatora modelu claude-sonnet-5-5 i małego żądania Messages lub Chat Completions. Istniejące agenty powinny ponownie przetestować thinking, wybór narzędzi i odtwarzanie historii przed wdrożeniem.

Key Takeaways

  • Używaj Claude Sonnet 5.5 i dopasuj format żądania do wybranego endpointu.
  • Zacznij od jednego krótkiego żądania, zanim dodasz obrazy, narzędzia lub długi kontekst.
  • Użyj Messages dla kontroli specyficznych dla Claude; użyj Chat Completions, jeśli masz istniejącą aplikację z OpenAI SDK.
  • Przejrzyj zmiany w thinking i wyborze narzędzi przed migracją istniejących pętli agenta.
  • Porównaj jakość zaakceptowanych zadań, opóźnienia, zużycie tokenów i trafienia cache przed rozszerzeniem ruchu.

What Is Claude Sonnet 5.5?

Claude Sonnet 5.5 API to programistyczny interfejs do modelu Sonnet 5.5 firmy Anthropic. Zaprojektowany jest do zadań takich jak rozwój oprogramowania, analiza repozytoriów, automatyzacja wsparcia klienta, przetwarzanie dokumentów, rozumienie obrazów, agenci korzystający z narzędzi oraz ustrukturyzowane profesjonalne przepływy pracy.

Anthropic pozycjonuje Sonnet 5.5 jako szybsze, tańsze uzupełnienie Opus 5.5, drugi model w rodzinie Claude 5.5, zoptymalizowany pod kątem dobrze zdefiniowanego kodowania, naprawiania błędów, tworzenia dokumentów i slajdów oraz codziennych zadań profesjonalnych. Deweloperzy mogą uzyskać dostęp do Claude Sonnet 5.5 API w CometAPI, używając claude-sonnet-5-5.

SpecyfikacjaClaude Sonnet 5.5
DostawcaAnthropic
Model IDclaude-sonnet-5-5
Data wydaniaSeptember 28, 2026
Okno kontekstu1M tokens
Maksymalny synchroniczny output128K tokens
Maksymalny output wsadowyUp to 300K tokens in supported beta configuration
WejściaText, images
WyjścieText
ThinkingAdaptive thinking
Domyślny effort Claude APIHigh
Granica wiedzyJune 2026
Cena wejścia (Anthropic / CometAPI)$2.00 / $1.60 per 1M tokens
Cena wyjścia (Anthropic / CometAPI)$10.00 / $8.00 per 1M tokens

Anthropic potwierdza okno kontekstu 1M tokenów i limit 128K tokenów dla synchronicznego outputu. Output wsadowy może osiągnąć 300K tokenów wyłącznie poprzez Message Batches z nagłówkiem beta output-300k-2026-03-24. Obsługę funkcji Gateway należy sprawdzić osobno względem wsparcia na poziomie modelu.

How Does Claude Sonnet 5.5 Perform on Official Benchmarks?

Poniższe zwarte zestawienie pomaga wskazać obciążenia do oceny przed przyjęciem API. Wyniki benchmarków nie zastępują testów własnych promptów i pętli narzędzi.

BenchmarkClaude Sonnet 5.5Claude Sonnet 5Claude Opus 5.5
Terminal-Bench 4.070.6%10.3%66.4% at Xhigh
FrontierCode 1.1 Main46.2% at Max / 52.1% at Xhigh42.4%54.4%
CursorBench 4.055.5%34.1%57.8%
GDPval-AA v2.1184414491846
OSWorld 2.1, partial80.1%57.0%81.8%
AA-Briefcase v1.1181113591822
Humanity’s Last Exam, with tools64.5%54.9%67.7%
Chartography, no tools61.6%15.6%64.4%

Wyniki benchmarków i notatki ewaluacyjne Anthropic stanowią podstawę tego porównania. Wynik Opus 5.5 na Terminal-Bench używa wysiłku Xhigh; FrontierCode raportuje osobno wyniki Max i Xhigh dla Sonnet 5.5; OSWorld to częściowa ewaluacja. GDPval-AA i AA-Briefcase zostały uruchomione przez Artificial Analysis na przedpremierowym wdrożeniu Claude Platform z błędem strukturalnego outputu, który prawdopodobnie zaniżył wynik Sonnet 5.5; Anthropic twierdzi, że błąd został od tego czasu naprawiony. Te wyniki powinny kierunkować testowanie obciążeń zamiast gwarantować rezultaty produkcyjne. Humanity’s Last Exam używa narzędzi; Chartography nie. Nowe wiersze używają opublikowanych wyników Anthropic. Oryginalny obraz poniżej został zachowany; rozszerzona tabela obejmuje trzy dodatkowe ewaluacje.

Jak korzystać z interfejsu API Claude Sonnet 5.5

Oficjalne porównanie benchmarków Claude Sonnet 5.5

What Changed in Claude Sonnet 5.5 API From Sonnet 5?

WymiarClaude Sonnet 5.5Wpływ na migrację
Prędkość outputuZgłaszane generowanie szybsze o 30%+Ustal na nowo bazowe opóźnienia
Oficjalne stawki tokenówTe same $2 input / $10 output per MTokPorównaj całkowity koszt zadania
Najniższa opcja thinkingbetween_tools zastępuje disabledZaktualizuj konfigurację thinking
Wymuszony wybór narzędziaOdrzucone any i wymuszanie nazwUżyj auto; sekwencjonuj wymagane kroki w kodzie
Historia thinkingPodpisana do konwersacji i kontaZachowaj bloki i stabilną historię
Zgodność z computer usecomputer_20251124 odrzucone na Claude API / Google CloudMigruj do computer_toolset_20260801; zweryfikuj wsparcie gateway
Zgodność modeli advisorWcześniejsze pary advisor odrzuconeWybierz wspierany advisor, np. Opus 5.5

Zmiany w thinking, wyborze narzędzi i odtwarzaniu historii wpływają na istniejące pętle agenta. Tabela podsumowuje te zmiany operacyjne; nie jest to pełny inwentarz funkcji.

Breaking Changes to Check

Sprawdź wszystkie pięć zmian niekompatybilnych: zastąp disabled dla thinking ustawieniem between_tools; usuń wymuszony wybór narzędzia; zachowaj kompatybilne bloki thinking i niezmienioną historię konwersacji; zmigruj z computer_20251124 na computer_toolset_20260801 w Claude API i Google Cloud; oraz zastąp niewspierane pary advisor. Amazon Bedrock nadal akceptuje computer_20251124. Niewspierani advisorzy obejmują Opus 4.8, 4.7, 4.6, Sonnet 5, Sonnet 4.6 i Haiku 5.5. Opus 5.5 to jedno z wspieranych zastępstw. Odczytuj bloki odpowiedzi według typu. Zweryfikuj zgodność platformy i gateway przed wdrożeniem. Oficjalny przewodnik migracji.

Additional Capabilities and Workflow Changes

Użyj oficjalnego przewodnika funkcji, aby przejrzeć postępy, effort per-message i sterowanie w trakcie konwersacji. Potwierdź wsparcie gateway przed włączeniem funkcji beta.

What Do You Need Before Using the Claude Sonnet 5.5 API?

  • Konto CometAPI, klucz API, dostęp do modelu i dostępne środki rozliczeniowe.
  • Terminal z cURL; Python i pip albo Node.js i npm do przykładów SDK.
  • Wybrany endpoint: /v1/messages lub /v1/chat/completions.
  • COMETAPI_KEY zapisany w środowisku serwera oraz dostęp sieciowy do https://api.cometapi.com.
  • Krótki testowy prompt i jasne sprawdzenie użytecznego outputu, statusu ukończenia i zużycia tokenów.

How Do You Access Claude Sonnet 5.5 API Through CometAPI?

Styl APIEndpointNajlepsze zastosowanie
Claude-native Messages APIPOST /v1/messagesNarzędzia specyficzne dla Claude, sterowanie thinking, przepływy agenta, struktury odpowiedzi Anthropic
OpenAI-compatible Chat CompletionsPOST /v1/chat/completionsIstniejące projekty z OpenAI SDK, routery modeli, aplikacje wielomodelowe

Wybierz Messages API, gdy zachowanie Claude ma znaczenie. Wybierz OpenAI-compatible API, gdy Twoja aplikacja już przełącza się między Claude, GPT, Gemini, DeepSeek lub innymi modelami przez tę samą warstwę abstrakcji.

Step 1: Store the API Key

Utwórz klucz w konsoli kluczy API CometAPI, a następnie ustaw go w środowisku wykonawczym.

Ustaw klucz CometAPI w powłoce POSIX

export COMETAPI_KEY="YOUR_COMETAPI_KEY"

Ustaw klucz CometAPI w PowerShell

$env:COMETAPI_KEY="YOUR_COMETAPI_KEY"

Step 2: Make the First Messages Request

Wyślij pierwsze żądanie Messages zgodne z Anthropic

curl https://api.cometapi.com/v1/messages \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 2048,
    "messages": [{"role": "user", "content": "Explain exponential backoff in three bullet points."}]
  }'

Sprawdź bloki content, stop_reason i usage, zanim dodasz więcej kontroli. Powyższa składnia cURL używa powłoki POSIX.

Step 3: Use the Anthropic Python SDK

Zainstaluj Anthropic Python SDK

pip install anthropic

Odczytaj bloki tekstowe i usage przy użyciu Anthropic SDK

import os
import anthropic

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

response = anthropic_client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=4096,
    messages=[{"role": "user", "content": "Review this migration plan and list the three biggest risks."}],
)

for block in response.content:
    if block.type == "text":
        print(block.text)
print("Completion:", response.stop_reason)
print("Usage:", response.usage)

Step 4: Use the OpenAI Python SDK

Zainstaluj OpenAI Python SDK

pip install openai

Wywołaj Sonnet 5.5 przez OpenAI-compatible Chat Completions

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-sonnet-5-5",
    messages=[
        {
            "role": "system",
            "content": "You are a concise software engineering assistant."
        },
        {
            "role": "user",
            "content": "Review this function and identify the highest-risk bug."
        }
    ],
)

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

To podejście jest użyteczne, gdy aplikacja już korzysta z interfejsu OpenAI SDK. Podstawowa integracja tekstowa może wymagać jedynie nowego base URL, klucza API i ID modelu, ale migracje produkcyjne nadal powinny zweryfikować wspierane parametry, formaty odpowiedzi, wywołania narzędzi, zdarzenia strumieniowe, limity czasu i rozliczanie tokenów.

Step 5: Use JavaScript in Node.js

Zainstaluj OpenAI Node.js SDK

npm install openai

Wywołaj Sonnet 5.5 z modułu ES w Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.COMETAPI_KEY,
  baseURL: "https://api.cometapi.com/v1",
});

const response = await client.chat.completions.create({
  model: "claude-sonnet-5-5",
  messages: [
    {
      role: "user",
      content: "Create a TypeScript function that validates an email address.",
    },
  ],
});

console.log(response.choices[0].message.content);

Dla backendowych aplikacji Node.js trzymaj COMETAPI_KEY w środowisku serwera zamiast wysyłania go do klienta przeglądarkowego.

Claude Sonnet 5.5 Thinking and Effort Levels

API domyślnie używa high effort; aplikacje Claude i Claude Code używają medium. Wybierz effort w oparciu o jakość zaakceptowanych zadań, opóźnienie i koszt tokenów. Poniższa tabela to redakcyjny punkt wyjścia, nie oficjalna klasyfikacja obciążeń.

ObciążenieSugerowany początkowy effort
EkstrakcjaLow
KlasyfikacjaLow
Rutynowa odpowiedź wsparciaLow lub Medium
Wyjaśnianie koduMedium
Naprawianie błędówMedium
Kodowanie na poziomie repozytoriumHigh
Złożony przepływ agentaHigh
Kosztowna recenzja produkcyjnaHigh, następnie porównaj z Opus
Wymagające, długofalowe kodowanie lub praca agentaXhigh, tylko gdy ewaluacja pokazuje wzrost jakości
Większość zadań wrażliwych na zdolności przy zaakceptowanym koszcieMax, tylko gdy ewaluacja uzasadnia dodatkowe opóźnienie i tokeny

Unikaj automatycznego ustawiania najwyższego effort dla każdego żądania. Przepływy agentów mogą stać się istotnie droższe, gdy dodatkowe rozumowanie generuje też więcej wywołań narzędzi i dłuższe outputy. Wybierz ustawienie na podstawie oceny na poziomie zadania. Użyj adaptive thinking dla Xhigh i Max, a następnie porównaj jakość zaakceptowanych zadań i całkowity koszt z niższymi poziomami. Oficjalne wskazówki dot. effort.

Configure Effort Through Messages

Ten przykład używa klienta Anthropic zainicjalizowanego powyżej. Przetestuj te same ustawienia na swojej trasie CometAPI przed wdrożeniem.

Skonfiguruj adaptive thinking i high effort

response = anthropic_client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=8192,
    thinking={"type": "adaptive"},
    output_config={"effort": "high"},
    messages=[{"role": "user", "content": "Audit this service migration plan."}],
)

Turn Off Up-Front Thinking

Użyj thinking={"type": "between_tools"} przy low, medium lub high effort. Użyj adaptive thinking dla xhigh lub max. between_tools nie przyjmuje pól display ani budget_tokens i nie pozwala zmieniać effort w trakcie konwersacji.

Preserve Thinking in Tool Loops

Zwracaj oryginalne bloki treści asystenta przed dołączeniem wyników narzędzia. Zachowanie thinking zależy od modelu, prefiksu konwersacji i konta, które go tworzy. Wiązanie prefiksu jest domyślnie wymuszane w Claude API, Amazon Bedrock i Google Cloud dla kont utworzonych w dniu lub po 31 sierpnia 2026, 00:00 UTC. Nie zakładaj, że każdy gateway udostępnia te same mechanizmy wiązania.

How to Stream Claude Sonnet 5.5 Responses

Stream Long Responses

Strumieniowanie jest przydatne dla interfejsów czatu, asystentów kodowania i długich odpowiedzi, ponieważ użytkownicy mogą zobaczyć output przed zakończeniem generowania.

Strumieniuj tekst przez OpenAI-compatible Chat Completions

from openai import OpenAI
import os

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

stream = client.chat.completions.create(
    model="claude-sonnet-5-5",
    messages=[
        {
            "role": "user",
            "content": "Explain how a retrieval-augmented generation pipeline works."
        }
    ],
    stream=True,
)

for chunk in stream:
    if not chunk.choices:
        continue
    delta = chunk.choices[0].delta.content
    if delta:
        print(delta, end="", flush=True)

Strumieniowanie zazwyczaj nie zmniejsza całkowitej liczby wygenerowanych tokenów. Jego główną korzyścią jest postrzegane opóźnienie. Aplikacje powinny również jawnie obsługiwać przerwane strumienie, częściowe outputy, ponowne próby sieciowe i anulowanie.

Use Tools With Automatic Selection

Użyj tool_choice={"type": "auto"}. Waliduj każdą nazwę narzędzia i argument, stosuj autoryzację i limity czasu, zwracaj wyniki ustrukturyzowane i ograniczaj liczbę iteracji. Wykonanie wymaganych narzędzi należy do orkiestracji aplikacji.

Zdefiniuj narzędzie wyszukiwania zgłoszenia i poproś o automatyczny wybór

tools = [{
    "name": "lookup_ticket",
    "description": "Retrieve a support ticket by ID",
    "input_schema": {
        "type": "object",
        "properties": {"ticket_id": {"type": "string"}},
        "required": ["ticket_id"],
        "additionalProperties": False,
    },
}]

response = anthropic_client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=4096,
    tools=tools,
    tool_choice={"type": "auto"},
    messages=[{"role": "user", "content": "Look up ticket T-123 and summarize its status."}],
)

Blok tool_use żąda akcji; to pierwsze wywołanie jej nie wykonuje. Zweryfikuj żądanie na swoim serwerze, uruchom operację, dołącz niezmienioną treść asystenta i wyślij pasujący tool_result. Schemat w tym przykładzie nadal wymaga walidacji po stronie aplikacji; ścisłe wsparcie narzędzi należy sprawdzić na wybranej trasie.

Use Prompt Caching for Repeated Context

Cache promptu jest przydatny, gdy żądania wielokrotnie zawierają ten sam duży prefiks, jak polityki systemowe, schematy narzędzi, mapy repozytoriów, dokumentacja produktu, wielokrotnego użytku instrukcje lub podręczniki referencyjne.

Sonnet 5.5 wymaga możliwego do zcache’owania prefiksu promptu co najmniej 512 tokenów. Krótsze prefiksy są przetwarzane bez cache, nawet przy cache_control. Sprawdź cache_creation_input_tokens i cache_read_input_tokens; oba jako zero oznaczają brak użycia cache. Potwierdź wsparcie na swojej trasie gateway. Referencja cache’owania promptów.

Ułóż stabilny kontekst przed dynamiczną treścią żądania

Stable system instructions
Stable tools
Stable repository or knowledge context
---------------- cache boundary ----------------
Current user request
Current retrieved context

Obecna stawka odczytu cache w CometAPI to $0.16 za milion tokenów, w porównaniu z $1.60 za świeży input. Zapisy cache są rozliczane osobno. Zweryfikuj trafienia cache w metadanych usage przed szacowaniem oszczędności.

Cache jest szczególnie użyteczny dla agentów kodujących i asystentów korporacyjnych, którzy ponownie używają dużych prefiksów kontekstu w wielu turach. Ekonomia nadal zależy od rzeczywistych trafień cache; częste przepisywanie stabilnego prefiksu może zniwelować oczekiwane korzyści.

Send Images Using the Selected Endpoint Schema

Sonnet 5.5 akceptuje input tekstowy i obrazowy. Poniższy JSON to payload kompatybilny z OpenAI Chat Completions; zamień przykładowy URL obrazu na publicznie dostępny obraz, który kontrolujesz. Messages używa innego schematu bloków obrazu.

Wyślij obraz w payloadzie Chat Completions

{
  "model": "claude-sonnet-5-5",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Find the three most important UI problems in this screenshot."
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://example.com/interface.png"
          }
        }
      ]
    }
  ]
}

Dokładny kształt żądania multimodalnego może się różnić między interfejsem natywnym Claude a interfejsem kompatybilnym z OpenAI, więc używaj schematu odpowiadającego endpointowi, który faktycznie wdrażasz, zamiast zakładać ich zamienność.

Handle Safeguards and Retained Data

Rejestruj odmowy i zachowania awaryjne jako jawne stany aplikacji. Anthropic opisuje zabezpieczenia i dostępność zero-data-retention dla swojej usługi. Osobno zweryfikuj właściwe zasady retencji i routingu dla Twojego gateway przed wysłaniem materiałów produkcyjnych.

Claude Sonnet 5.5 vs Sonnet 5 vs Opus 5.5

Poniższe jakościowe etykiety to redakcyjne wskazówki routingu oparte na zakresie zadań, a nie oficjalne oceny wydajności. Zweryfikuj te role na reprezentatywnych obciążeniach. Szczegółowej architektury nie należy wnioskować na podstawie wyników benchmarków.

WymiarClaude Sonnet 5Claude Sonnet 5.5Claude Opus 5.5
Rutynowe kodowanieStrongStronger and fasterCzęsto niepotrzebny
Praca na repozytoriumStrongVery strongNajlepiej pasuje do trudniejszych przypadków
Dobrze zdefiniowani agenciStrongPrimary fitPrzydatny dla trudniejszych przepływów
Niejasna, długotrwała pracaGoodVery goodPrimary fit
Prędkość outputuBaseline30%+ faster than Sonnet 5Bardziej zoptymalizowany pod zdolności niż tani throughput
Oficjalny input$2/M$2/M$4/M
Oficjalny output$10/M$10/M$20/M
Typowa rola produkcyjnaIstniejące obciążenia SonnetDomyślny kandydat SonnetEskalacja / warstwa wysokiej złożoności
Okno kontekstu1M tokens1M tokens1M tokens
Input / outputText and images / textText and images / textText and images / text
ThinkingAdaptiveAdaptive; between_tools at high or belowAdaptive, always on
Dostępność APIIstniejąca integracja CometAPICometAPI Messages i kompatybilne Chat CompletionsDostępny przez CometAPI

Kieruj trudne zadania do modelu eskalacyjnego

Routine task
    ↓
Claude Sonnet 5.5
    ↓
Confidence / validation failure?
    ├── No → Return result
    └── Yes → Escalate difficult case
                 ↓
              Opus-class model

Ten wzorzec routingu może obniżyć koszt, zapewniając jednocześnie dostęp do silniejszej warstwy rozumowania dla trudnych przypadków.

Claude Sonnet 5.5 Pricing Through CometAPI

Rodzaj wycenyAnthropicCometAPI
Input$2.00 / 1M tokens$1.60 / 1M tokens
Output$10.00 / 1M tokens$8.00 / 1M tokens
Odczyt cache$0.10 / 1M tokens$0.16 / 1M tokens
Zapis cache (TTL 5 min)$2.50 / 1M tokens$2.00 / 1M tokens

Sprawdzone 10 października 2026: w CometAPI input/output pozostają $1.60/$8 za milion tokenów, 20% poniżej $2/$10 w Anthropic. Odczyt/zapis cache w CometAPI to nadal $0.16/$2; bieżące stawki cache w Anthropic to $0.10/$2.50 dla zapisu z pięciominutowym TTL. Strona startowa wciąż pokazuje $0.20 za odczyty cache; ta rewizja używa bieżącej referencji cache’owania. Ceny gateway mogą zmieniać się niezależnie.

Różnica między ceną za token a kosztem zadania ma znaczenie dla aplikacji agentowych. Agent kodujący może wygenerować mniej tokenów, ale wciąż wykonać wiele rund wywołań narzędzi, odczytów cache, inspekcji kodu, ponowień i walidacji. Koszt na pomyślnie ukończone zadanie jest więc zwykle bardziej informacyjny niż sama cena za input token.

Oszacuj opłaty za świeży input i tokeny outputu

Input:
100,000 / 1,000,000 × $1.60 = $0.16

Output:
5,000 / 1,000,000 × $8.00 = $0.04

Estimated model-token cost:
$0.20

Opłaty za narzędzia, operacje cache, powtórzone kroki agenta lub inne funkcje płatne mogą zmienić końcowy koszt.

Stawki ponownie sprawdzone 10 października 2026 względem aktualnej strony modelu CometAPI. Ceny za świeży input/output są niezmienione, więc przykład obliczeniowy pozostaje $0.16 + $0.04 = $0.20 dla 100,000 świeżych input i 5,000 output tokenów. Nie obejmuje zapisów cache, odczytów cache, opłat za narzędzia ani ponowień. Przed budżetowaniem ponownie sprawdź rozliczanie specyficzne dla trasy.

Control Cost per Accepted Task

Istnieje kilka praktycznych sposobów ograniczania wydatków bez natychmiastowej zmiany modelu. Po pierwsze, jasno zdefiniuj kryteria ukończenia:

Zdefiniuj skupiony format akceptacji odpowiedzi

Return only:
1. the root cause;
2. the affected file;
3. the smallest safe fix;
4. one regression test.

Po drugie, przytnij kontekst pobrany przed jego wysłaniem. Okno kontekstu 1M tokenów to limit pojemności, a nie cel. Po trzecie, ponownie używaj stabilnego kontekstu poprzez cache promptów. Po czwarte, dobieraj effort do obciążenia zamiast ustawiania High dla każdego żądania. Po piąte, mierz koszt na zaakceptowane zadanie:

Oblicz koszt na zaakceptowane zadanie

Total API cost
÷
Number of outputs accepted without rework

Tańsze żądanie niekoniecznie oznacza tańszy przepływ, jeśli powoduje dodatkowe ponowienia, korekty lub wywołania narzędzi.

How Do You Migrate From Sonnet 5 to Claude Sonnet 5.5 API?

  1. Zachowaj poprzednią konfigurację produkcyjną do ewentualnego wycofania.
  2. Zmień ID modelu z claude-sonnet-5 na claude-sonnet-5-5.
  3. Zastosuj opisane powyżej zmiany w thinking, wyborze narzędzi i historii.
  4. Odtwórz reprezentatywne żądania, w tym narzędzia, obrazy i strumieniowanie.
  5. Porównaj zaakceptowane outputy, wskaźnik ludzkich korekt, opóźnienia p50/p95 i całkowity koszt zadania.
  6. Przetestuj ponowienia, odmowy, anulowania i przerwane strumienie.
  7. Zweryfikuj trafienia cache i zachowanie budżetu outputu w metadanych usage.
  8. Wypuść mały kanarek ruchu i zwiększaj go dopiero po spełnieniu progów akceptacji.

Troubleshooting Claude Sonnet 5.5 API Errors

ObjawCo sprawdzić
400: invalid thinking settingZastąp disabled ustawieniem between_tools przy high lub niższym; użyj adaptive dla xhigh/max.
400: forced tool selectionUsuń any lub wymuszenie nazw narzędzi; użyj auto.
400 po odtworzeniu historiiDla kont wymuszających wiązanie prefiksu utrzymaj niezmienione podpisane thinking i poprzedzającą historię; sprawdź zgodność modelu/konta i wybraną trasę.
401 / 403Sprawdź poświadczenia, uprawnienia i dostęp do modelu.
429 / retryable 5xxUżyj ograniczonego exponential backoff z jitter i honoruj Retry-After, jeśli dostarczony.
Odpowiedź nie zawiera zwykłego tekstuSprawdź typy content, status ukończenia, odmowę i zachowanie awaryjne.
Output kończy się zbyt wcześnieSprawdź stop_reason lub finish_reason; dostosuj budżet outputu i użyj strumieniowania.
Cache nigdy nie trafiaSprawdź stabilny prefiks i metadane użycia cache.
Rozłączenia strumieniaZachowaj częściowy output i ponawiaj zgodnie z zasadami idempotencji aplikacji.

Nie ponawiaj niepoprawnie sformatowanych żądań ani błędów uwierzytelnienia bez zmian. Zapobiegaj duplikowaniu akcji narzędzi podczas odtwarzania przerwanych przebiegów agenta.

Claude Sonnet 5.5 Production Best Practices

Wybierz obciążenie, zdefiniuj bramkę akceptacji i oceń kompletną aplikację. Loguj ID modelu, endpoint, effort, opóźnienie, zużycie tokenów i cache, awarie narzędzi, status ukończenia i wynik zaakceptowanego zadania. Przechowuj klucze po stronie serwera oraz skonfiguruj limity czasu, ograniczone ponowienia i limity iteracji agenta.

Measure Workflow Quality and Reliability

MetrykaDlaczego ma znaczenie
Wskaźnik sukcesu zadańMierzy faktyczną realizację przepływu
Wskaźnik korekt ręcznychUjawnia ukryte problemy jakościowe
Tokeny wejścioweKontrolują koszt kontekstu
Tokeny wyjścioweKontrolują koszt generowania
Wskaźnik trafień cacheOkreśla wartość cache’owania
Liczba wywołań narzędziWykrywa nieefektywnych agentów
Nieprawidłowe wywołania narzędziMierzy niezawodność orkiestracji
Wskaźnik ponowieńUjawnia niestabilność API lub przepływu
Opóźnienie p50Typowe doświadczenie użytkownika
Opóźnienie p95Długie ogony doświadczenia użytkownika
Koszt na zaakceptowane zadanieŁączy jakość i ekonomię

Dla agentów kodujących śledź również liczbę zaliczonych testów, zbędnie modyfikowanych plików, wycofanych łatek i pomyślne ukończenia bez interwencji człowieka.

Example: Fix a Well-Scoped Repository Bug

Dostarcz test, który nie przechodzi, istotne pliki źródłowe i oczekiwane zachowanie. Poproś o skupioną łatkę z testem regresji. Bramka akceptacji to powtarzalna poprawka, przechodzące odpowiednie testy i brak niepowiązanych edycji. Porównaj łączny koszt API i narzędzi z zaakceptowanymi łatkami.

Example: Triage a Support Ticket

Pobierz problem klienta i zatwierdzone fragmenty bazy wiedzy. Poproś model o klasyfikację problemu, szkic odpowiedzi popartej dowodami i oznaczenie spraw wymagających eskalacji. Zaakceptuj wynik tylko wtedy, gdy jego twierdzenia odpowiadają pobranemu materiałowi, a decyzja routingu zgodna jest z polityką wsparcia.

Example: Review a Document and Screenshot

Dostarcz zatwierdzoną procedurę i zrzut ekranu odpowiadającego interfejsu. Poproś o rozbieżności z odniesieniami do odpowiedniego fragmentu i widocznego elementu UI. Wymagaj, by recenzent potwierdził ustalenia przed zmianą procedury.

Conclusion

Claude Sonnet 5.5 daje zespołom praktycznego kandydata do szybkiego kodowania, wsparcia, pracy z dokumentami i przepływów z użyciem narzędzi. Zacznij od działającego żądania w CometAPI, następnie dodaj kontrolki potrzebne Twojej aplikacji.

Migracja wymaga czegoś więcej niż zmiany ID modelu: sprawdź ustawienia thinking, automatyczny wybór narzędzi, parsowanie odpowiedzi i odtwarzanie historii. Promuj model, gdy ewaluacje Twoich obciążeń pokażą akceptowalną równowagę jakości, opóźnień i kosztu; zarezerwuj silniejszą warstwę dla zadań, które nie przejdą bramki akceptacji.

FAQ

How Should Teams Rotate a Claude Sonnet 5.5 API Key Without Downtime?

Przechowuj klucze w serwerowym menedżerze sekretów i pozwól workerom przeładowywać poświadczenia bez osadzania ich w kodzie aplikacji. Jeśli dostawca wspiera nakładające się aktywne klucze, najpierw wprowadź zamiennik, zweryfikuj małe żądanie, stopniowo przełączaj workery, a następnie unieważnij poprzedni klucz. Monitoruj błędy uwierzytelnienia podczas zmiany i unikaj logowania któregokolwiek klucza.

How Can a Claude Sonnet 5.5 Job Resume After a Worker Restart?

Utrwal identyfikator zadania, ostatni ukończony krok, konfigurację żądania i rejestry wykonania narzędzi. Wznów od zweryfikowanego punktu kontrolnego. Przed powtórzeniem akcji narzędzia sprawdź, czy już się zakończyła i czy bezpiecznie ją powtórzyć. Sam zapisany transkrypt nie zapobiega duplikatowi zgłoszeń, wiadomości ani zapisów w bazie danych.

How Should Teams Detect Claude Sonnet 5.5 Behavior Changes Over Time?

Utrzymuj datowany zestaw ewaluacyjny z zaakceptowanymi odpowiedziami lub kontrolami akceptacji, wraz z wersjami SDK i ustawieniami żądań. Uruchamiaj go okresowo oraz po zmianach u dostawcy, w SDK, w promptach lub w routingu. Porównuj sukces zadań, wskaźnik korekt, opóźnienia i całkowity koszt. Jeśli konto oferuje przypięcie wersji, potwierdź jego gwarancje, zanim na nim polegniesz; utrzymuj ścieżkę wycofania dla krytycznych przepływów.

Kontynuuj naukę

Połącz ten artykuł z następną decyzją.

Zobacz wszystkie tematy
Opublikowano Oct 13, 2026
Ostatnia aktualizacja Oct 13, 2026
0 wyświetleń
Sprawdzone pod kątem przejrzystości, atrybucji źródeł i aktualnej terminologii API.

Czytaj więcej