Wprowadzenie
Claude Opus 4.5 to model czatu z linii Opus od Anthropic, udostępniony tu jako jeden endpoint zgodny z OpenAI pod /v1/chat/completions. Okno 198 000 tokenów mieści dziesiątki tur historii słowo w słowo, a pojedyncza odpowiedź może liczyć do 32 768 tokenów – tyle, ile trzeba na całą scenę albo krótki rozdział.
Obok poziomu rozumowania low, medium lub high przyjmuje temperature (od 0 do 1, domyślnie 1) i top_p. Treść wiadomości to tekst i obrazy, do żądania możesz dołączyć do 128 narzędzi, a na życzenie odpowiedź płynie strumieniem przez Server-Sent Events.
Najważniejsze funkcje
198 000 tokenów czytanych dokładnie tak, jak powstały
Po trzydziestu turach roleplayu jako pierwsza zawodzi pamięć, nie proza: skąd pochodzi postać, na co się zgodziła, jakiej granicy obiecała nigdy nie przekroczyć. 198 000 tokenów trzyma tę historię w żądaniu słowo w słowo, więc model czyta oryginalne kwestie, a nie streszczenie, które zgubiło akurat te najważniejsze.
Próbkowanie, którym wciąż sterujesz
temperature przyjmuje wartości od 0 do 1, domyślnie 1, a top_p od 0,01 do 1. Obniż temperature przy przebiegu sprawdzającym ciągłość, który nie może niczego dopisywać, a zostaw 1 w dialogach, które mają zaskakiwać. Poziom rozumowania to osobne ustawienie: low, medium lub high.
Ustrukturyzowany wynik przez wymuszone wywołanie narzędzia
Ten endpoint nie ma response_format, więc wynik czytelny dla maszyny idzie przez narzędzia: do 128 definicji funkcji na żądanie, z tool_choice ustawionym na auto, none, required albo jedną wskazaną funkcję. Umieść schemat JSON w parametrach narzędzia, wymuś to narzędzie i zwaliduj zwrócone argumenty.
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 32 768 – mniej więcej jednej szóstej okna odczytu. Domyślnie 4 096; podnieś je przed pisaniem rozdziału. |
reasoning_effort | Nie | low, medium albo high, domyślnie medium. Podnieś, gdy odpowiedź musi pogodzić szczegóły, zanim model zacznie pisać. |
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 na 0 zawsze wtedy, gdy odpowiedź parsuje kod, i zostaw w spokoju, gdy utwór ustalił już swój głos. |
top_p | Nie | Od 0,01 do 1. W jednym porównaniu ruszaj to albo temperature, nigdy oba naraz. |
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 $4.50 / Wyjście $22.50 za 1 mln tokenów
Zastosowania
Czat z postacią, która nie wychodzi z roli
Kartę postaci wyślij w wiadomości systemowej, a bieżącą transkrypcję jako messages. Nawet dziesiątki tur później model potrafi przytoczyć obietnicę z trzeciej tury, bo trzecia tura wciąż jest w żądaniu.
Kontynuacje długości sceny
32 768 tokenów to mniej więcej długa scena albo krótki rozdział. Poproś o kolejną scenę z max_tokens podniesionym ponad domyślne 4 096, a dostaniesz ją w jednym kawałku, nie w trzech fragmentach sklejanych ręcznie.
Stan fabuły, który zapisze twoja aplikacja
Zdefiniuj narzędzie w rodzaju update_story_state z polami na miejsce, relacje i otwarte wątki, wymuszaj je co kilka tur i zapisuj argumenty w aplikacji. Proza i stan powstają z tego samego kontekstu, więc sobie nie przeczą.
Wskazówki
Persona i granice w wiadomości systemowej
Pochodzenie, sposób mówienia, twarde granice, osoba narracji i czas gramatyczny należą do wiadomości systemowej, która nigdy nie wypada z żądania. Wiadomość użytkownika niech niesie tylko bieżącą turę – wtedy późniejsze przycinanie tnie transkrypcję, a nigdy postać.
Podnieś max_tokens, zanim poprosisz o długość
Domyślne 4 096 tokenów wystarcza na kilka stron. Na całą scenę ustaw max_tokens jawnie, maksymalnie na 32 768; odpowiedź uciętą w połowie akapitu trudniej uratować niż taką, która od początku miała być krótka.
Wiedz, gdzie kończy się okno
Przy mniej więcej sześciu tokenach czytanych na jeden pisany żądanie, by odtworzyć długie wejście, najpierw trafi w limit odpowiedzi, a max_tokens powyżej 32 768 nie przejdzie walidacji. Części wideo i audio są odrzucane, a 198 000 tokenów obejmuje łącznie prompt systemowy, historię i każdy wynik narzędzia.
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-opus-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.
