Wprowadzenie
Claude Sonnet 4.5 to model czatu Anthropic, udostępniony tu jako jeden endpoint zgodny z OpenAI pod /v1/chat/completions. Czyta do 198 000 tokenów i odpowiada do 64 000 – mniej więcej trzy tokeny wejścia na jeden wyjścia, czyli kształt sceny albo rozdziału: karta postaci i transkrypcja na wejściu, kilka tysięcy słów prozy z powrotem.
Żądanie przyjmuje temperature (od 0 do 1, domyślnie 1) i top_p; ten endpoint nie ma ustawienia poziomu rozumowania. Treść wiadomości to tekst i obrazy, w jednym wywołaniu mieści się do 128 schematów narzędzi, a przy stream: true pierwsze zdanie przychodzi, zanim reszta zostanie dopisana.
Najważniejsze funkcje
Okno na miarę jednego wątku fabularnego
198 000 tokenów mieści kartę postaci, zasady świata i długą transkrypcję bez streszczania co kilka tur. To, co nie może dryfować – głos, temperament, kanon – trzymaj w wiadomości systemowej, a scenę niech niesie wiadomość użytkownika.
64 000 tokenów odpowiedzi
Limit odpowiedzi to 64 000 tokenów, więc rozdział nigdy nie urwie się w połowie akapitu z braku miejsca. max_tokens domyślnie wynosi 4 096, czyli kilkaset słów, więc podnieś go, gdy chcesz scenę napisaną w całości.
Strumieniowanie przy grze na zmianę
Roleplay to wymiana tur, a ktoś patrzy na kursor. Przy stream: true odpowiedź przychodzi kawałkami przez Server-Sent Events, więc pierwsze zdanie jest już na ekranie, gdy reszta dopiero powstaje.
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. Wartość domyślna 4 096 to kilkaset słów, więc podnieś ją, gdy chcesz scenę rozpisaną w całości. |
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 |
temperature | Nie | Od 0 do 1, domyślnie 1. Trzymaj ją blisko 0 zawsze, gdy odpowiedź parsuje kod. |
top_k | Nie | Od 1 do 500. Próbkowanie odbywa się tylko spośród k najbardziej prawdopodobnych kolejnych tokenów: 1 sprawia, że odpowiedzi są niemal powtarzalne, większe wartości luzują wybór. |
top_p | Nie | Od 0,01 do 1. Zmieniaj to pole albo temperature, nigdy oba w tym samym porównaniu. |
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 $2.70 / Wyjście $13.50 za 1 mln tokenów
Zastosowania
Długo prowadzona sesja roleplayu
Karta postaci i zasady świata zostają w wiadomości systemowej, a transkrypcja rośnie w tablicy messages. 198 000 tokenów to sceny całego wątku, więc głos się trzyma i nie trzeba go prostować streszczeniem.
Rozdział interaktywnej fikcji
Fikcja z rozgałęzieniami to najpierw czytanie, potem pisanie: kilka tysięcy tokenów stanu i historii na wejściu, scena prozy na wyjściu. Trzy do jednego to dokładnie ten kształt, a limit 64 000 tokenów daje rozdziałowi miejsce, żeby się skończył.
Zespół BN-ów w jednym wątku
Daj każdej postaci własną sekcję w wiadomości systemowej, a w wiadomości użytkownika wskaż, kto jest na scenie. Ponieważ wszyscy bohaterowie niezależni są opisani w tym samym żądaniu, pozostają spójni ze sobą nawzajem, a nie tylko każdy z osobna.
Wskazówki
Postać w wiadomości systemowej
Karta postaci, głos i zasady świata idą do wiadomości systemowej, scena do wiadomości użytkownika. Gdy później przycinasz długość, tniesz transkrypcję, a postać zostaje dokładnie taka, jaką ją napisałeś.
Dobierz temperature do zadania
Trzymaj temperature blisko 1 w dialogach, które mają brzmieć żywo, i obniżaj ją przy sprawdzaniu ciągłości albo streszczaniu wydarzeń. top_p dodatkowo zawęża dobór słów, gdy scena musi trzymać wąski rejestr.
Ustrukturyzowany wynik i twarde limity
Nie ma tu response_format: zdefiniuj narzędzie, którego parametrami jest pożądany schemat JSON, ustaw na nie tool_choice i zwaliduj zwrócone argumenty. max_tokens powyżej 64 000 nie przechodzi walidacji, a części z wideo i audio są odrzucane.
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-4.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.
