Claude Sonnet 5.5

Używaj claude-sonnet-5-5 w formacie Anthropic Messages. Ta dokumentacja rozróżnia oficjalną specyfikację żądań od zachowania zaobserwowanego w testach zgodności. Niektóre zaawansowane opcje nie działają jeszcze zgodnie ze specyfikacją; zapoznaj się z ograniczeniami, zanim zaczniesz na nich polegać.

Aktualne ceny danych wejściowych, danych wyjściowych i pamięci podręcznej znajdziesz na stronie modelu.

Szybki start

curl https://api.seedrouter.ai/v1/messages \
  -H "x-api-key: $SEEDROUTER_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Explain how a rainbow forms in three sentences."}]
  }'

POST /v1/messages akceptuje uwierzytelnianie przez x-api-key lub Bearer oraz anthropic-version: 2023-06-01. Wysyłaj nagłówek anthropic-beta dla funkcji, których oficjalna dokumentacja go wymaga. Przechowuj dane uwierzytelniające w kodzie po stronie serwera.

Model akceptuje także podstawowe żądania OpenAI Chat Completions (POST /v1/chat/completions) i Responses (POST /v1/responses). Używaj Messages do obsługi natywnych parametrów opisanych poniżej; konwersja formatu OpenAI nie udostępnia wszystkich funkcji Anthropic.

Oficjalna specyfikacja parametrów

Sonnet 5.5 ma okno kontekstu o rozmiarze 1M tokenów i limit synchronicznych danych wyjściowych wynoszący 128000 tokenów. Limity danych wyjściowych specyficzne dla przetwarzania wsadowego nie dotyczą tego punktu końcowego. Właściwości opcjonalne nie mają wartości domyślnych nadawanych przez aplikację, chyba że tabela wskazuje inaczej.

between_tools akceptuje tylko swoją właściwość type i poziom wysiłku low, medium lub high. Nie wysyłaj z nim display, budget_tokens ani block_binding. Przykład:

{
  "model": "claude-sonnet-5-5",
  "max_tokens": 1024,
  "thinking": {"type": "between_tools"},
  "output_config": {"effort": "medium"},
  "messages": [{"role": "user", "content": "Explain this concept briefly."}]
}

Wstępne wypełnianie odpowiedzi asystenta nie jest obsługiwane. Aby kontynuować pause_turn, ponownie wyślij zwróconą treść wiadomości asystenta z narzędziami serwerowymi bez żadnych zmian. Kompaktowanie podsumowuje istniejącą historię i nie jest wstępnym wypełnianiem odpowiedzi asystenta. Zachowuj bloki rozumowania i podpisy dokładnie w oryginalnej postaci; nie przenoś ich między modelami ani nie edytuj wcześniejszej historii bez przestrzegania oficjalnych reguł wiązania.

W natywnym API Claude obsługa komputera wymaga computer_toolset_20260801; computer_20251124 jest odrzucane. Konfiguracje doradcy używające claude-opus-4-8, claude-opus-4-7 lub claude-sonnet-5 również są odrzucane dla tego modelu wykonawczego.

Pola żądań z modelami rezerwowymi

Oficjalna funkcja beta fallbacks ponawia żądania po kwalifikujących się odmowach klasyfikatora. Nie ponawia ich w przypadku limitów częstotliwości, przeciążenia ani błędów serwera, a odmowa może pozostać nierozwiązana. Wyślij server-side-fallback-2026-07-01 dla "default" lub jawnej listy; server-side-fallback-2026-06-01 obsługuje tylko listę. Inne wersje oznaczone datą są odrzucane.

Jawna lista zawiera maksymalnie trzy pozycje z różnymi modelami; żaden z nich nie może być modelem wskazanym w żądaniu. Dozwolone modele docelowe pochodzą z allowed_fallback_models w wersji beta Models API. Każda pozycja może zawierać tylko model, max_tokens, thinking, output_config i speed; nadpisane wartości muszą być prawidłowe dla danego modelu docelowego. Lipcowa wersja beta przekształca between_tools w Sonnet 5.5 na disabled w Sonnet 5 z pominiętym wyświetlaniem, gdy następuje takie przejście do modelu rezerwowego. W czerwcowej wersji beta samodzielnie podaj nadpisanie ustawienia rozumowania dla Sonnet 5.

fallback_credit_token służy do osobnego ponowienia żądania po odmowie. Ciąg znaków wybiera ścisły tryb realizacji kredytu; obiekt dodaje mode. W trybie strict nieudana realizacja kredytu powoduje odrzucenie ponownego żądania. W trybie best_effort błąd w warstwie tokena może pozwolić na kontynuację według normalnej ceny i jest rejestrowany w usage.fallback_credit; nieprawidłowy format tokena i łączenie kredytu z fallbacks nadal powodują błąd. Realizacja kredytu wymaga również spełnienia warunków dotyczących żądania, konta, obszaru roboczego, platformy i pięciominutowego okna, opisanych w oficjalnym przewodniku po kredycie.

Żądanie o nieszkodliwej treści z fallbacks: "default", nagłówkiem lipcowej wersji beta i speed: "standard" zwróciło oczekiwany tekst. Potwierdza to wyłącznie przyjęcie żądania: wykonanie przez model rezerwowy i realizacja kredytu nie zostały tu zweryfikowane od początku do końca.

Media i narzędzia na wejściu

Obrazy używają bloków image, a pliki PDF bloków document w wiadomości użytkownika. Oficjalne typy źródeł obejmują publiczne adresy URL i base64 z odpowiednim typem MIME. Testy zgodności wykorzystywały plik PNG w base64 oraz jednostronicowy PDF w base64 i sprawdzały treść odpowiedzi. Nie obejmowały wszystkich przypadków granicznych dotyczących adresów URL, rozmiaru plików, rozdzielczości obrazów ani liczby stron PDF.

Narzędzia po stronie klienta używają standardowej wymiany tool_use → tool_result. Zachowaj identyfikatory użycia narzędzi bez zmian i zwróć wynik w wiadomości użytkownika. Udany przykład narzędzia w trybie ścisłym potwierdza poprawność argumentów tego przykładu, a nie każdego obsługiwanego słowa kluczowego JSON Schema.

Odpowiedzi

Odpowiedź bez przesyłania strumieniowego zawiera id, type: "message", role: "assistant", model, content, stop_reason, stop_sequence i usage, a także opcjonalne oficjalne pola, takie jak container, diagnostics, context_management, stop_details i pola odpowiedzi beta. Treść może zawierać tekst, rozumowanie, wywołania narzędzi, wyniki narzędzi lub inne oficjalne typy bloków; nie zakładaj, że pierwszy blok jest tekstem.

Przy przesyłaniu strumieniowym obsługuj message_start, content_block_start, content_block_delta, content_block_stop, message_delta i message_stop. Błędy mogą też wystąpić w trakcie strumienia. Użycie może obejmować zwykłe tokeny wejściowe/wyjściowe, szczegóły tokenów rozumowania, odczyty pamięci podręcznej i oddzielne liczby tokenów zapisanych przy tworzeniu pamięci podręcznej na 5 minut / 1 godzinę.

Oficjalna odmowa klasyfikatora jest zwykłą odpowiedzią z stop_reason: "refusal" i stop_details, a nie błędem HTTP. W odpowiedzi modelu rezerwowego model wskazuje model, który odpowiedział, bloki treści fallback oznaczają przejścia, a usage.iterations opisuje próby. Sprawdzaj te pola, zamiast zakładać, że odpowiedź wygenerował model wskazany w żądaniu. Te zachowania odpowiedzi pozostają tu niezweryfikowane.

Błędy Messages mają postać {"type":"error","error":{"type":"...","message":"..."}}. Za nieudane żądania nie są pobierane opłaty.

Weryfikacja zgodności: 2026-10-01

Wykonywanie narzędzi beta, rzeczywiste połączenia MCP, odwołania do Files API, rezydencja geograficzna danych, ponowne przesyłanie podpisów rozumowania, pełne limity kontekstu/danych wyjściowych, przypadki graniczne mediów oraz zachowania odmowy/modeli rezerwowych nie zostały zweryfikowane od początku do końca. HTTP 200 i zwrócona nazwa modelu nie uwierzytelniają modelu, który faktycznie został uruchomiony, ani nie dowodzą, że wszystkie przesłane opcje odniosły skutek.

Źródła

• Oficjalne omówienie Sonnet 5.5
• Zmiany i ograniczenia Sonnet 5.5
• Dokumentacja parametrów Messages
• Poziom wysiłku dla pojedynczej wiadomości
• Kompaktowanie na żądanie
• Odmowy i modele rezerwowe
• Kredyt na model rezerwowy
• Schemat OpenAPI
• Markdown do skopiowania