Introduzione
Claude Opus 4.6 è un modello di chat della linea Opus di Anthropic, disponibile qui come un endpoint compatibile con OpenAI su /v1/chat/completions. Legge fino a 1.000.000 di token per richiesta e può scriverne fino a 128.000 in una risposta, così una collaborazione lunga viaggia per intero e un capitolo torna in un pezzo solo.
Il livello di ragionamento ha quattro impostazioni – low, medium, high e max, con medium di default – e temperature (da 0 a 1) e top_p restano regolabili. Il contenuto dei messaggi è testo e immagini, e nella stessa chiamata hai fino a 128 tool e lo streaming SSE.
Caratteristiche principali
Quattro livelli di ragionamento, max compreso
max sta sopra high ed è pensato per le richieste in cui dettagli seminati, una cronologia e un lungo elenco di fatti stabiliti devono tornare prima che venga scritta una parola. Il ragionamento si paga in token di output: tieni i turni quotidiani su low o medium e riserva max ai passaggi che lo giustificano.
1.000.000 di token in ingresso, 128.000 in uscita
Circa otto token letti per ognuno scritto. L'intero manoscritto, il foglio di stile e le note delle sessioni precedenti stanno in una sola richiesta, e il tetto della risposta è abbastanza alto da non dover spezzare e ricomporre un capitolo intero.
temperature e top_p restano nelle tue mani
Accanto al livello di ragionamento sono accettati temperature da 0 a 1 e top_p da 0,01 a 1. Un controllo di continuità può girare freddo e ripetibile mentre un turno di brainstorming gira caldo, senza cambiare modello né endpoint.
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 128.000, un ottavo della finestra di lettura. Default 4.096; alzalo prima di scrivere un capitolo. |
reasoning_effort | No | low, medium, high o max, 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, default 1. Tienila a 0 ogni volta che la risposta viene letta da del codice, e lasciala stare quando un'opera ha trovato la sua voce. |
top_p | No | Da 0,01 a 1. Regola questo oppure la 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 $5 / Output $25 per 1 milione di token
Casi d’uso
Editing su scala di manoscritto
Manda la bozza completa con un foglio di stile e chiedi una revisione riga per riga di un capitolo, con ogni modifica motivata rispetto al foglio. Il modello vede come parla ogni personaggio in tutto il libro, non solo nel capitolo che sta rivedendo.
Narrativa collaborativa lunga
Centinaia di turni di una storia condivisa possono tornare in ogni richiesta senza uno strato di riassunto. Una promessa fatta all'inizio viene riletta con le parole originali quando finalmente la storia ne ha bisogno.
Un passaggio accurato su max
Quando una risposta deve far tornare una cronologia, una rete di relazioni e un elenco di fili aperti, manda quella richiesta su max con un max_tokens da capitolo intero, poi torna a medium per i turni normali.
Consigli avanzati
Adatta il ragionamento al turno, non alla sessione
La maggior parte dei turni non richiede una lunga riflessione. Lascia medium come default, scendi a low negli scambi rapidi e sali a high o max solo nel turno che tira le fila; è una sola stringa nello stesso corpo della richiesta.
Dimensiona max_tokens sulla risposta che vuoi
Il default è 4.096 token, e un capitolo ne richiede molti di più. Anche i token di ragionamento vengono fatturati come output, quindi lascia margine sopra la risposta visibile che ti aspetti, fino a 128.000.
Limiti da conoscere
Un max_tokens oltre 128.000 non supera la validazione e le parti video e audio vengono rifiutate. Una conversazione non può finire con un messaggio assistant per precompilare la risposta, e non esiste response_format: l'output strutturato passa da un tool con il tuo schema JSON come parametri, forzato con tool_choice.
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.6/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.
