Introduzione
Claude Sonnet 4.5 è un modello di chat di Anthropic disponibile qui come un endpoint compatibile con OpenAI su /v1/chat/completions. Legge fino a 198.000 token e risponde con fino a 64.000: circa tre token in ingresso per ognuno in uscita, che è la forma di una scena o di un capitolo, con scheda del personaggio e trascrizione in ingresso e diverse migliaia di parole di prosa in risposta.
La richiesta accetta temperature (da 0 a 1, default 1) e top_p; questo endpoint non ha un'impostazione del livello di ragionamento. Il contenuto dei messaggi è testo e immagini, in una chiamata stanno fino a 128 schemi di tool e con stream: true la prima frase arriva mentre il resto è ancora in scrittura.
Caratteristiche principali
Una finestra su misura per un arco narrativo
198.000 token contengono scheda del personaggio, regole del mondo e una lunga trascrizione senza un passaggio di riassunto ogni pochi turni. Ciò che non deve scivolare – voce, temperamento, canone – va nel messaggio di sistema, e il messaggio utente porta la scena.
64.000 token di risposta
Il tetto della risposta è di 64.000 token, quindi un capitolo non si ferma mai a metà paragrafo per mancanza di spazio. max_tokens parte da 4.096, qualche centinaio di parole, perciò alzalo quando vuoi una scena scritta per intero.
Streaming per i turni di battuta
Il roleplay è un botta e risposta, e qualcuno sta guardando il cursore. Con stream: true la risposta arriva a pezzi via Server-Sent Events, così la prima frase è già a schermo mentre il resto viene ancora generato.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
messages | Sì | Turni di conversazione ordinati. Il contenuto è una stringa o un array di parti text e |
max_tokens | No | Limita la risposta a 64.000. Il valore predefinito di 4.096 sono qualche centinaio di parole, quindi alzalo quando vuoi una scena scritta per intero. |
stop | No | Fino a 4 sequenze, come stringa o come array. La risposta si ferma appena il modello ne scrive una, e il testo corrispondente non viene restituito. almeno 1 caratteri · almeno 1 elementi · al massimo 4 elementi |
temperature | No | Da 0 a 1, 1 per impostazione predefinita. Tienila vicina a 0 ogni volta che la risposta viene analizzata da codice. |
top_k | No | Da 1 a 500. Si campiona solo tra i k token successivi più probabili: 1 rende le risposte quasi ripetibili, valori più alti allentano la scelta. |
top_p | No | Da 0,01 a 1. Regola questo oppure temperature, mai entrambi nello stesso confronto. |
tools | No | Fino a 128 definizioni di funzioni per richiesta. al massimo 128 elementi |
parallel_tool_calls | No | true o false, predefinito true: il modello può chiedere più chiamate agli strumenti nello stesso turno. Predefinito: |
tool_choice | No | auto, none, required, oppure un oggetto che nomina una funzione. |
Prezzi
Input $2.70 / Output $13.50 per 1 milione di token
Casi d’uso
Una sessione di roleplay che dura a lungo
Scheda del personaggio e regole del mondo restano nel messaggio di sistema mentre la trascrizione cresce nell'array messages. 198.000 token valgono le scene di un intero arco, quindi la voce regge senza doverla rimettere in forma con un riassunto.
Un capitolo di narrativa interattiva
La narrativa a bivi è leggere e poi scrivere: qualche migliaio di token di stato e cronologia in ingresso, una scena di prosa in uscita. Tre a uno è esattamente questa forma, e il tetto di 64.000 token lascia al capitolo lo spazio per finire.
Un gruppo di PNG nello stesso thread
Dai a ogni personaggio una sezione del messaggio di sistema e lascia che il messaggio utente dica chi è in scena. Poiché tutti i PNG sono descritti nella stessa richiesta, restano coerenti tra loro e non solo con sé stessi.
Consigli avanzati
Metti il personaggio nel messaggio di sistema
Scheda del personaggio, voce e regole del mondo vanno nel messaggio di sistema; la scena va nel messaggio utente. Quando più avanti tagli per lunghezza, tagli la trascrizione e il personaggio resta esattamente come l'hai scritto.
Regola temperature in base al compito
Tieni temperature vicino a 1 per i dialoghi che devono sembrare vivi e abbassala per un passaggio di continuità o un riepilogo di quanto è successo. top_p restringe ancora di più la scelta delle parole quando una scena deve mantenere un registro stretto.
Output strutturato e limiti rigidi
Qui non c'è response_format: definisci un tool i cui parametri siano lo schema JSON che vuoi, punta tool_choice su di esso e valida gli argomenti che tornano. Un max_tokens oltre 64.000 non supera la validazione e le parti video e audio vengono rifiutate.
Avvio rapido dell’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'
Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.
