Introduzione
Claude Opus 4.5 è un modello di chat della linea Opus di Anthropic, disponibile qui come un endpoint compatibile con OpenAI su /v1/chat/completions. Una finestra da 198.000 token tiene decine di turni di cronologia parola per parola, e una singola risposta può arrivare a 32.768 token: abbastanza per una scena intera o un capitolo breve.
Oltre al livello di ragionamento low, medium o high accetta temperature (da 0 a 1, default 1) e top_p. Il contenuto dei messaggi è testo e immagini, puoi collegare fino a 128 tool a una richiesta e, se lo chiedi, la risposta arriva in streaming via Server-Sent Events.
Caratteristiche principali
198.000 token, letti così come sono stati scritti
Dopo trenta turni di un roleplay a cedere per prima è la memoria, non la prosa: da dove viene il personaggio, che cosa ha accettato, quale limite ha giurato di non superare. 198.000 token mantengono quella cronologia parola per parola nella richiesta, così il modello legge le battute originali e non un riassunto che ha già perso proprio quelle che contavano.
Un campionamento che puoi ancora regolare
temperature va da 0 a 1 con default 1, top_p da 0,01 a 1. Abbassa temperature per un passaggio di continuità che non deve inventare nulla, e lasciala a 1 per i dialoghi che devono sorprenderti. Il livello di ragionamento è un'impostazione a parte: low, medium o high.
Output strutturato tramite una chiamata a tool forzata
Questo endpoint non ha response_format, quindi l'output leggibile da una macchina passa dai tool: fino a 128 definizioni di funzione per richiesta, con tool_choice su auto, none, required o una funzione precisa. Metti lo schema JSON nei parametri di un tool, forza quel tool e valida gli argomenti che tornano.
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 32.768 – circa un sesto della finestra di lettura. Valore predefinito 4.096; alzalo prima di scrivere un capitolo. |
reasoning_effort | No | low, medium o high, medium di default. Alzalo quando la risposta deve conciliare i dettagli prima che il modello scriva. |
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, predefinito 1. Tienila a 0 ogni volta che la risposta viene analizzata da del codice, e lasciala stare quando un'opera ha ormai trovato una voce. |
top_p | No | Da 0,01 a 1. Regola questo oppure temperature, mai entrambi nello stesso confronto. |
tools | No | Fino a 128 definizioni di funzione 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 singola funzione. |
Prezzi
Input $4.50 / Output $22.50 per 1 milione di token
Casi d’uso
Chat con un personaggio che resta nel ruolo
Manda la scheda del personaggio nel messaggio di sistema e la trascrizione in corso nei messages. Decine di turni dopo il modello può ancora citare cosa è stato promesso al turno tre, perché il turno tre è ancora nella richiesta.
Continuazioni lunghe una scena
32.768 token corrispondono più o meno a una scena lunga o a un capitolo breve. Chiedi la scena successiva con max_tokens alzato rispetto al default di 4.096 e arriverà in un pezzo solo, non in tre frammenti uniti a mano.
Stato della storia che la tua app può salvare
Definisci un tool come update_story_state con campi per luogo, relazioni e fili aperti, forzalo ogni pochi turni e salva gli argomenti nella tua app. Prosa e stato nascono dallo stesso contesto, quindi non si contraddicono.
Consigli avanzati
Persona e limiti nel messaggio di sistema
Origine, modo di parlare, limiti invalicabili, persona narrativa e tempo verbale vanno nel messaggio di sistema, che non esce mai dalla richiesta. Il messaggio utente porta solo il turno corrente, così un taglio successivo toglie trascrizione e mai personaggio.
Alza max_tokens prima di chiedere lunghezza
Il default di 4.096 token basta per qualche pagina. Per una scena intera imposta max_tokens in modo esplicito, fino a 32.768; una risposta troncata a metà paragrafo è più difficile da recuperare di una pensata breve fin dall'inizio.
Sappi dove finisce la finestra
Con circa sei token letti per ognuno scritto, una richiesta che chiede di riprodurre un input lungo sbatte prima contro il tetto della risposta, e un max_tokens oltre 32.768 non supera la validazione. Le parti video e audio vengono rifiutate, e i 198.000 token comprendono insieme prompt di sistema, cronologia e ogni risultato dei tool.
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-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'
Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.
