Claude Sonnet 5.5

Usa claude-sonnet-5-5 con il formato Anthropic Messages. Questo documento distingue la specifica ufficiale delle richieste dal comportamento osservato nei test di compatibilità. Alcune opzioni avanzate non si comportano ancora come previsto dalla specifica; consulta le limitazioni prima di farvi affidamento.

Consulta la pagina del modello per i prezzi attuali di input, output e cache.

Avvio rapido

curl https://api.seedrouter.ai/v1/messages \
  -H "x-api-key: $SEEDROUTER_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Explain how a rainbow forms in three sentences."}]
  }'

POST /v1/messages accetta l’autenticazione tramite x-api-key o Bearer e anthropic-version: 2023-06-01. Invia un header anthropic-beta per le funzionalità la cui documentazione ufficiale lo richiede. Conserva le credenziali nel codice lato server.

Il modello accetta anche richieste di base OpenAI Chat Completions (POST /v1/chat/completions) e Responses (POST /v1/responses). Usa Messages per i parametri nativi descritti di seguito; la conversione del formato OpenAI non offre tutte le funzionalità di Anthropic.

Specifica ufficiale dei parametri

Sonnet 5.5 ha una finestra di contesto di 1M token e un limite di output sincrono di 128000 token. I limiti di output specifici di Batch non si applicano a questo endpoint. Le proprietà facoltative non hanno valori predefiniti impostati dall’applicazione, salvo diversa indicazione nella tabella.

between_tools accetta soltanto la propria proprietà type e i livelli di effort low, medium o high. Non inviare display, budget_tokens o block_binding con questa modalità. Esempio:

{
  "model": "claude-sonnet-5-5",
  "max_tokens": 1024,
  "thinking": {"type": "between_tools"},
  "output_config": {"effort": "medium"},
  "messages": [{"role": "user", "content": "Explain this concept briefly."}]
}

Il precompilamento dell’assistente non è supportato. Per continuare un pause_turn, reinvia senza modifiche il contenuto assistant dello strumento server restituito nella risposta. La compattazione riassume la cronologia esistente e non è un precompilamento dell’assistente. Conserva esattamente i blocchi di pensiero e le firme; non spostarli tra modelli e non modificare la cronologia precedente senza seguire le regole ufficiali di associazione.

Nell’API nativa di Claude, l’uso del computer richiede computer_toolset_20260801; computer_20251124 viene rifiutato. Per questo modello esecutore vengono rifiutate anche le configurazioni Advisor che usano claude-opus-4-8, claude-opus-4-7 o claude-sonnet-5.

Campi della richiesta di fallback

La funzionalità beta ufficiale fallbacks ritenta i rifiuti del classificatore che soddisfano i requisiti. Non ritenta in caso di limiti di frequenza, sovraccarichi o errori del server, e il rifiuto può persistere. Invia server-side-fallback-2026-07-01 per usare "default" o un elenco esplicito; server-side-fallback-2026-06-01 supporta soltanto l’elenco. Le altre versioni datate vengono rifiutate.

Un elenco esplicito contiene al massimo tre voci con modelli diversi, nessuno uguale al modello richiesto. I modelli di destinazione consentiti provengono da allowed_fallback_models della beta Models API. Per ogni voce sono ammessi soltanto model, max_tokens, thinking, output_config e speed; i valori sovrascritti devono essere validi per il modello di destinazione. Quando si verifica quel fallback, la beta di luglio converte between_tools di Sonnet 5.5 in disabled di Sonnet 5, omettendo display. Con la beta di giugno, devi specificare tu la sovrascrittura del pensiero per Sonnet 5.

fallback_credit_token serve per un nuovo tentativo separato dopo un rifiuto. Una stringa seleziona l’applicazione rigorosa del credito; un oggetto aggiunge mode. In modalità strict, se l’applicazione del credito fallisce, il nuovo tentativo viene rifiutato. In modalità best_effort, un errore a livello del token può consentire di proseguire al prezzo normale e viene registrato in usage.fallback_credit; i token non validi nel formato e l’uso del credito insieme a fallbacks continuano a fallire. Per applicare il credito, devono essere soddisfatti anche i requisiti relativi a richiesta, account, area di lavoro, piattaforma e finestra di cinque minuti descritti nella guida ufficiale al credito.

Una richiesta dal contenuto innocuo con fallbacks: "default", l’header beta di luglio e speed: "standard" ha restituito il testo previsto. Questo dimostra soltanto che la richiesta è stata accettata: l’esecuzione del fallback e l’applicazione del credito non sono state verificate dall’inizio alla fine qui.

Input multimediali e degli strumenti

Le immagini usano blocchi image e i PDF blocchi document in un messaggio utente. I tipi di sorgente ufficiali includono URL pubblici e base64 con il tipo MIME corrispondente. I controlli di compatibilità hanno usato un PNG in base64 e un PDF di una pagina in base64, verificando il contenuto delle risposte. Non hanno testato ogni URL né tutti i limiti di dimensione dei file, risoluzione delle immagini o numero di pagine PDF.

Gli strumenti lato client usano lo scambio standard tool_use → tool_result. Mantieni invariati gli ID di utilizzo degli strumenti e restituisci il risultato in un messaggio utente. Il successo di un esempio di strumento in modalità rigorosa verifica gli argomenti di quell’esempio, non tutte le parole chiave supportate di JSON Schema.

Risposte

Una risposta senza streaming contiene id, type: "message", role: "assistant", model, content, stop_reason, stop_sequence e usage, oltre a campi ufficiali facoltativi come container, diagnostics, context_management, stop_details e campi di risposta beta. Il contenuto può includere testo, pensiero, chiamate agli strumenti, risultati degli strumenti o altri tipi di blocco ufficiali; non presumere che il primo blocco sia testo.

Con lo streaming, gestisci message_start, content_block_start, content_block_delta, content_block_stop, message_delta e message_stop. Gli errori possono verificarsi anche all’interno del flusso. L’utilizzo può includere token ordinari di input/output, dettagli sui token di pensiero, letture della cache e conteggi separati per la creazione di cache con durata di 5 minuti / 1 ora.

Un rifiuto ufficiale del classificatore è una risposta normale con stop_reason: "refusal" e stop_details, non un errore HTTP. In una risposta di fallback, model identifica il modello che ha risposto, i blocchi di contenuto fallback indicano le transizioni e usage.iterations descrive i tentativi. Esamina questi campi invece di presumere che la risposta provenga dal modello richiesto. Questi comportamenti di risposta restano non verificati qui.

Gli errori di Messages usano {"type":"error","error":{"type":"...","message":"..."}}. Le richieste non riuscite non vengono addebitate.

Verifica di compatibilità: 2026-10-01

L’esecuzione di strumenti beta, le connessioni MCP reali, i riferimenti Files API, la residenza geografica dei dati, il reinvio delle firme di pensiero, i limiti completi di contesto/output, i casi limite multimediali e il comportamento di rifiuto/fallback non sono stati validati dall’inizio alla fine. HTTP 200 e il nome del modello restituito non autenticano quale modello sia stato eseguito né dimostrano che tutte le opzioni inviate abbiano avuto effetto.

Riferimenti

• Panoramica ufficiale di Sonnet 5.5
• Modifiche e restrizioni di Sonnet 5.5
• Riferimento dei parametri Messages
• Effort per messaggio
• Compattazione su richiesta
• Rifiuti e fallback
• Credito di fallback
• Schema OpenAPI
• Markdown da copiare