# API Claude Opus 5.5 (https://wanapi.app/it/docs/claude-opus-5-5)





Questa documentazione descrive **Claude Opus 5.5** e i suoi parametri Messages. Usa `claude-opus-5-5` con `POST https://api.wanapi.app/v1/messages`. [Confronta i modelli Claude](/it/docs/claude-api).

## Impostazioni del modello [#impostazioni-del-modello]

| Impostazione                                     | Claude Opus 5.5                       |
| ------------------------------------------------ | ------------------------------------- |
| ID del modello                                   | `claude-opus-5-5`                     |
| Finestra di contesto                             | 1M token                              |
| Output sincrono massimo                          | 128000 token, incluso il ragionamento |
| Modalità di ragionamento                         | Adattivo, sempre attivo               |
| Livello di impegno predefinito                   | `medium`                              |
| Chiamate forzate agli strumenti (`any` / `tool`) | Non supportate                        |

## Connessione e invio di una richiesta [#connessione-e-invio-di-una-richiesta]

Crea una chiave nelle [impostazioni delle chiavi API](/it/settings/apikeys). Un'unica chiave API funziona con tutti i modelli e gruppi. Conservala nell'ambiente del server come `WAN_API_KEY`. Invia `anthropic-version: 2023-06-01`; aggiungi `anthropic-beta` solo per le funzionalità che lo richiedono.

```bash
curl https://api.wanapi.app/v1/messages \
  -H "x-api-key: $WAN_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Explain the purpose of a database index in three sentences."}]
  }'
```

```python
import os
import anthropic

client = anthropic.Anthropic(
    api_key=os.environ["WAN_API_KEY"],
    base_url="https://api.wanapi.app",
)
message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Explain the purpose of a database index in three sentences."}],
)
print("".join(block.text for block in message.content if block.type == "text"))
```

## Supporto attuale dell'API [#supporto-attuale-dellapi]

La tabella seguente descrive il contratto nativo di questo modello. Wan API inoltra attualmente le richieste tramite un livello di compatibilità. &#x2A;*Usa un valore positivo per `max_tokens`**: il gateway sostituisce attualmente `0` con un budget di generazione, quindi qui non è possibile usarlo per il solo preriscaldamento della cache.

Il gateway attuale non inoltra `diagnostics`, `compaction`, `fallbacks`, `fallback_credit_token` o `thread`. Nella configurazione attuale del canale filtra anche `speed`, `service_tier` e `inference_geo`. Questi campi sono documentati di seguito per spiegare il contratto del modello, ma non sono ancora disponibili tramite questa connessione. Una risposta riuscita non significa che un campo ignorato abbia avuto effetto. Le funzionalità beta che richiedono questi campi hanno la stessa limitazione.

## Parametri [#parametri]

| Nome                                                                                                      | Tipo                | Obbligatorio | Predefinito            | Note                                                                                                                                                                                                                                                  |
| --------------------------------------------------------------------------------------------------------- | ------------------- | ------------ | ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `model`                                                                                                   | stringa             | Sì           | —                      | `claude-opus-5-5`.                                                                                                                                                                                                                                    |
| `max_tokens`                                                                                              | intero              | Sì           | —                      | 0–128000. Include i token usati per il ragionamento. `0` preriscalda soltanto la cache del prompt.                                                                                                                                                    |
| `messages`                                                                                                | object\[]           | Sì           | —                      | Turni `user` e `assistant` alternati; `content` è una stringa o un array di blocchi di contenuto. L'ultimo turno deve essere `user`. Eccezione: per proseguire una risposta `pause_turn`, reinvia il suo contenuto come ultimo messaggio `assistant`. |
| `system`                                                                                                  | stringa o object\[] | No           | —                      | Prompt di sistema.                                                                                                                                                                                                                                    |
| `thinking`                                                                                                | oggetto             | No           | `{"type": "adaptive"}` | Il ragionamento è adattivo e sempre attivo. `display`: `omitted` (predefinito) o `summarized`.                                                                                                                                                        |
| `output_config.effort`                                                                                    | enum                | No           | `medium`               | `low`, `medium`, `high`, `xhigh`, `max`. Regola quanto ragiona il modello.                                                                                                                                                                            |
| `output_config.format`                                                                                    | oggetto             | No           | —                      | Uno schema JSON per l'output strutturato.                                                                                                                                                                                                             |
| `stop_sequences`                                                                                          | string\[]           | No           | —                      | Arresta quando viene generata una di queste stringhe.                                                                                                                                                                                                 |
| `stream`                                                                                                  | booleano            | No           | `false`                | Trasmette la risposta come eventi inviati dal server.                                                                                                                                                                                                 |
| `temperature`                                                                                             | numero              | No           | —                      | È accettato solo `1` (il valore predefinito) per retrocompatibilità; qualsiasi altro valore restituisce un errore 400. Omettilo.                                                                                                                      |
| `top_p`                                                                                                   | numero              | No           | —                      | Sono accettati solo valori da `0.99` a `1` per retrocompatibilità; qualsiasi altro valore restituisce un errore 400. Omettilo.                                                                                                                        |
| `top_k`                                                                                                   | intero              | No           | —                      | Non accettato: qualsiasi valore restituisce un errore 400. Omettilo.                                                                                                                                                                                  |
| `tools`                                                                                                   | object\[]           | No           | —                      | Definizioni degli strumenti.                                                                                                                                                                                                                          |
| `tool_choice`                                                                                             | oggetto             | No           | —                      | `auto` o `none`; questo modello non supporta chiamate forzate agli strumenti (`any` o `tool`).                                                                                                                                                        |
| `metadata.user_id`                                                                                        | stringa             | No           | —                      | Un ID opaco per l'utente finale, fino a 512 caratteri.                                                                                                                                                                                                |
| `cache_control`                                                                                           | oggetto             | No           | —                      | Punto di interruzione della cache del prompt al livello principale.                                                                                                                                                                                   |
| `container`, `context_management`, `mcp_servers`, `diagnostics`, `service_tier`, `inference_geo`, `speed` | —                   | No           | —                      | Campi nativi facoltativi; vedi Supporto attuale dell'API per i campi filtrati da questa connessione.                                                                                                                                                  |

## Ragionamento e strumenti [#ragionamento-e-strumenti]

Claude Opus 5.5 usa sempre il ragionamento adattivo: il modello decide quanto ragionare e `output_config.effort` lo orienta. Un livello di impegno più alto comporta generalmente più token di output, un'attesa più lunga e un costo maggiore. Con `thinking.display` impostato su `summarized`, la risposta include blocchi `thinking` che puoi mostrare; con `omitted`, vengono omessi. I token di ragionamento vengono fatturati come token di output.

## Input multimediali [#input-multimediali]

Per immagini e PDF, usa URL HTTP(S) pubblicamente accessibili nei blocchi `content` di un messaggio utente. Ospita autonomamente i tuoi file; questa integrazione non fornisce un'API Files né il caricamento di file. Esempio di input immagine:

```json
{"role":"user","content":[
  {"type":"image","source":{"type":"url","url":"https://example.com/chart.png"}},
  {"type":"text","text":"What does this chart show?"}
]}
```

Usa un blocco `document` per un PDF. Mantieni invariati gli ID degli strumenti, i blocchi di ragionamento completi e le firme quando prosegui una conversazione. La tua applicazione esegue gli strumenti client e ne restituisce i risultati; dichiarare uno strumento non lo esegue.

## Prezzi [#prezzi]

USD per 1 milione di token

Le tariffe attuali includono il moltiplicatore di ciascun gruppo. I prezzi vengono memorizzati nella cache per un massimo di 2 minuti.

Un'unica chiave API funziona con tutti i modelli e gruppi. Predefinito indica il primo gruppo idoneo nell'ordine di instradamento automatico; la richiesta viene addebitata alle tariffe del gruppo effettivamente selezionato.

### Claude Opus 5.5

`claude-opus-5-5`

| Token fatturabili | claude · Predefinito · Tutte le lunghezze dell'input |
| --- | ---: |
| Input (non in cache) | 2 USD |
| Output | 10 USD |
| Lettura dalla cache | 0,1 USD |
| Scrittura nella cache · 5 minuti | 2,5 USD |
| Scrittura nella cache · 1 ora | 4 USD |

— indica che non è disponibile una tariffa verificata; non significa che il servizio sia gratuito.

Le tariffe della cache si applicano solo quando la risposta riporta il relativo utilizzo. Non conteggiare nuovamente i token in cache come input non in cache.

Moltiplica ciascun conteggio dei token fatturabili per la tariffa corrispondente e dividi il totale per 1.000.000. I token di ragionamento sono inclusi nei token di output e non vengono addebitati una seconda volta. Letture dalla cache, scritture di 5 minuti e scritture di 1 ora hanno tariffe distinte. Per i prezzi basati sulla lunghezza, scegli la fascia applicabile prima di calcolare il costo della richiesta.

## Risposta e streaming [#risposta-e-streaming]

Un messaggio completato include `id`, `type`, `role`, `model`, `content`, `stop_reason` e `usage`. Leggi i blocchi di testo da `content`; il primo blocco potrebbe invece contenere ragionamento o una chiamata a uno strumento. Questo esempio è illustrativo:

```json
{
  "id": "msg_example",
  "type": "message",
  "role": "assistant",
  "model": "claude-opus-5-5",
  "content": [{"type": "text", "text": "A database index helps locate rows without scanning the whole table."}],
  "stop_reason": "end_turn",
  "usage": {"input_tokens": 24, "output_tokens": 18}
}
```

Imposta `stream: true` per SSE e usa `curl -N`. Gestisci `message_start`, `content_block_start`, `content_block_delta`, `content_block_stop`, `message_delta` e `message_stop`, oltre a `ping` e agli errori dello stream. Leggi l'utilizzo finale anziché trattare ogni frammento come una risposta completa.

## Formati compatibili con OpenAI [#formati-compatibili-con-openai]

Lo stesso ID del modello funziona con `POST /v1/chat/completions` e `POST /v1/responses`. Usa `Authorization: Bearer YOUR_API_KEY` e l'URL di base dell'SDK OpenAI `https://api.wanapi.app/v1`. Chat Completions usa `messages`; Responses usa `input`. I rispettivi campi vengono convertiti in Messages, quindi usa `/v1/messages` per i parametri nativi documentati sopra.

```bash
curl https://api.wanapi.app/v1/chat/completions \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-opus-5-5","max_tokens":256,"messages":[{"role":"user","content":"Reply with OK."}]}'
```

## Log di utilizzo ed errori [#log-di-utilizzo-ed-errori]

I [log LLM](/it/usage) mostrano le chiamate completate negli ultimi 7 giorni, con modello, token di input, token di output e costo. Aggiorna dopo una chiamata e filtra per `claude-opus-5-5`. Usa i [log delle attività](/it/tasks) per immagini e video.

Esamina lo stato HTTP e l'oggetto `error` quando una richiesta non riesce. Verifica la chiave, il [saldo](/it/docs/balance), l'ID del modello e le combinazioni di parametri supportate. Un rifiuto o un arresto per limite di output è diverso da un errore HTTP. Se una richiesta o uno stream si interrompe, controlla i log prima di riprovare: una nuova richiesta può comportare un ulteriore addebito.
