Wprowadzenie
Claude Sonnet 5 to model czatu Anthropic do codziennej, ciężkiej pracy, udostępniony tu jako jeden endpoint zgodny z OpenAI pod /v1/chat/completions. Czyta do 1 000 000 tokenów na wywołanie i pisze do 64 000 w jednej odpowiedzi, więc długa sesja może przy każdej turze jechać w całości.
Poziom rozumowania przyjmuje low, medium lub high, domyślnie medium. Próbkowanie ustala sam model, więc temperature i top_p nie są akceptowane; treść wiadomości to tekst i obrazy, a w tym samym wywołaniu masz do 128 narzędzi i strumieniowanie SSE.
Najważniejsze funkcje
Pamięć sesji na milion tokenów
Setki oryginalnych tur mieszczą się pod limitem 1 000 000 tokenów. Odeślij je po kolei, a model przeczyta, co każda postać naprawdę powiedziała – i stąd bierze się większość tego, co nazywa się spójnością.
Więcej rozumowania tylko wtedy, gdy się opłaca
low, medium i high dzielą tę samą treść żądania. Zwykła wymiana zdań dobrze działa na low i wraca szybciej; podnieś poziom, gdy wątki muszą się zbiec albo kilka postaci dzieli scenę. Wyższy poziom myśli dłużej i zwykle generuje więcej tokenów wyjścia.
Treść żądania bez pokręteł próbkowania
Ponieważ temperature i top_p ustala model, żądanie skopiowane ze starszej integracji powinno je pominąć: wysłanie któregokolwiek kończy się błędem walidacji, a nie cichym zignorowaniem, więc zapomniane ustawienie nigdy nie zmieni zachowania za twoimi plecami.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
messages | Tak | Uporządkowane tury rozmowy. Treść to ciąg znaków albo tablica części text i |
max_tokens | Nie | Ogranicza odpowiedź do 64 000 – jednej szesnastej okna odczytu. Domyślnie 4 096. |
reasoning_effort | Nie | low, medium albo high, domyślnie medium. Zwykłe wymiany puszczaj na low, a przy scenie, która musi wyjść, podnoś wyżej. |
stop | Nie | Do 4 sekwencji, jako string albo tablica. Odpowiedź kończy się, gdy tylko model zapisze którąś z nich, a dopasowany tekst nie jest zwracany. od 1 znaków · od 1 elementów · do 4 elementów |
tools | Nie | Do 128 definicji funkcji na żądanie. do 128 elementów |
parallel_tool_calls | Nie | true lub false, domyślnie true: model może w jednej turze zażądać kilku wywołań narzędzi. Domyślnie: |
tool_choice | Nie | auto, none, required albo obiekt wskazujący jedną funkcję. |
Cennik
Wejście $1.90 / Wyjście $9.50 za 1 mln tokenów
Zastosowania
Długie rozmowy z towarzyszem
Trzymaj bieżącą rozmowę w tablicy messages sesja po sesji. Przy milionie tokenów nawet długi łuk relacji mieści się bez warstwy streszczeń, a postać odwołuje się do prawdziwych kwestii, nie do parafraz.
Trzy lub cztery głosy w jednej scenie
Zapisz dykcję i twarde granice każdej postaci w wiadomości systemowej, a tury użytkownika niech niosą tylko akcję. Skoro każda wcześniejsza tura wciąż jest w oknie, wiadomo, kto co powiedział, i głosy się ze sobą nie mieszają.
Kości, ekwipunek i lore jako narzędzia
Zdefiniuj funkcje do rzutów kośćmi, sprawdzania ekwipunku albo wyszukiwania w lore i pozwól tool_choice decydować, kiedy się uruchamiają. Wyniki przychodzą jako wiadomości tool w tym samym wątku, więc historia rozstrzyga akcję, nie wychodząc poza rozmowę.
Wskazówki
low na zwykłe tury, high na scenę, która się liczy
Wymiany zdań zwykle dobrze znoszą low, a oszczędzasz przy tym czas tak samo jak tokeny. Podnieś poziom, gdy wątki muszą się zbiec; to jeden string w tym samym żądaniu.
Ustaw max_tokens na długość, jakiej chcesz
Domyślne 4 096 wystarcza na solidną scenę. Myślenie pochodzi z tego samego budżetu, więc mały limit może zostać zużyty na rozumowanie, zanim zacznie się odpowiedź; przy wysokim poziomie zostaw prawdziwy zapas, maksymalnie do 64 000.
Limity, które trzeba uwzględnić
Części z wideo i audio są odrzucane, rozmowa nie może kończyć się wiadomością assistant, która z góry wypełni odpowiedź, i nie ma response_format – jeśli potrzebujesz wyniku czytelnego dla maszyny, wymuś narzędzie, którego parametrami jest twój schemat JSON. Wyniki narzędzi dzielą okno z rozmową, więc bardzo długą sesję w końcu trzeba przyciąć.
Szybki start z API
curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "anthropic/claude-sonnet-5/chat",
"messages": [
{
"role": "user",
"content": "Summarise the following release notes into three bullet points."
}
],
"stream": true
}' \
| jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'
Uwierzytelnianie, pełny schemat, odpytywanie i obsługę błędów opisuje dokumentacja API.
