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





Questa documentazione descrive **Claude Haiku 5.5** e i suoi parametri Messages. Usa `claude-haiku-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 Haiku 5.5                      |
| ------------------------------------------------ | ------------------------------------- |
| ID del modello                                   | `claude-haiku-5-5`                    |
| Output sincrono massimo                          | 128000 token, incluso il ragionamento |
| Modalità di ragionamento                         | Adattivo o disabilitato               |
| Livello di impegno predefinito                   | `medium`                              |
| Chiamate forzate agli strumenti (`any` / `tool`) | 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-haiku-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-haiku-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]

| Campo                   | Obbligatorio | Contratto                                                                                                                                                   |
| ----------------------- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `model`                 | Sì           | `claude-haiku-5-5`.                                                                                                                                         |
| `max_tokens`            | Sì           | Intero 0–128000, incluso il ragionamento. Nessun valore predefinito dell'API.                                                                               |
| `messages`              | Sì           | 1–100000 messaggi con un ruolo e una stringa o un array di blocchi di contenuto. Vedi le regole della conversazione di seguito.                             |
| `system`                | No           | Stringa o array di blocchi di testo. Non null.                                                                                                              |
| `thinking`              | No           | Adattivo per impostazione predefinita, oppure disabilitato. Nessun budget manuale e nessuna modalità tra le chiamate agli strumenti.                        |
| `output_config`         | No           | Oggetto con `effort`, `format` e il campo beta facoltativo `task_budget`.                                                                                   |
| `stop_sequences`        | No           | Array di stringhe di arresto.                                                                                                                               |
| `stream`                | No           | Booleano; false per impostazione predefinita.                                                                                                               |
| `temperature`           | No           | Da omettere. Qui viene scartato; il valore di compatibilità ufficiale è 1.                                                                                  |
| `top_p`                 | No           | Da omettere. Qui viene scartato; il valore di compatibilità ufficiale è 0.99.                                                                               |
| `top_k`                 | No           | Non supportato e scartato.                                                                                                                                  |
| `tools`                 | No           | Array di strumenti client o dichiarazioni ufficiali di strumenti server.                                                                                    |
| `tool_choice`           | No           | `auto`, `none`, `any` oppure `tool` con nome. Sono supportate le chiamate forzate agli strumenti.                                                           |
| `metadata`              | No           | Oggetto; il campo facoltativo `user_id` è una stringa di massimo 512 caratteri o null.                                                                      |
| `cache_control`         | No           | Null oppure `{"type":"ephemeral","ttl":"5m"}`; il TTL accetta anche `1h`. Il TTL predefinito è 5m.                                                          |
| `container`             | No           | Null, stringa con l'ID del contenitore oppure oggetto con ID facoltativo e fino a 20 skill.                                                                 |
| `context_management`    | No           | Null oppure oggetto contenente modifiche ufficiali al contesto; si applicano gli header beta.                                                               |
| `mcp_servers`           | No           | Array di massimo 20 server URL; richiede un header beta MCP corrispondente.                                                                                 |
| `service_tier`          | No           | `auto` o `standard_only`. Haiku non dispone di capacità Priority Tier.                                                                                      |
| `inference_geo`         | No           | `global`, `us` o null. Se omesso usa il valore predefinito dell'account; esamina l'utilizzo riportato prima di presumere una regione.                       |
| `diagnostics`           | No           | Null oppure oggetto; `previous_message_id` è null o una stringa di massimo 256 caratteri.                                                                   |
| `compaction`            | No           | Null oppure `{"type":"summarize","instructions":"..."}`. Le istruzioni sono facoltative, accettano null e hanno un massimo di 16384 caratteri.              |
| `fallbacks`             | No           | Null o `default` con la beta corrispondente. Haiku non ha modelli di fallback automatici; gli elenchi espliciti non sono validi.                            |
| `fallback_credit_token` | No           | Null, stringa del token oppure `{token,mode}`. L'API deve verificarne idoneità e validità; non presumere che qualsiasi modello sia una destinazione idonea. |
| `speed`                 | No           | `standard` o null. La modalità veloce non è supportata.                                                                                                     |

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

L'impostazione predefinita è il ragionamento adattivo con livello di impegno **medium** e testo del ragionamento omesso. Il livello di impegno accetta `low`, `medium`, `high`, `xhigh`, `max` oppure null per usare il valore predefinito.

```json
{
  "thinking": {"type": "adaptive", "display": "summarized"},
  "output_config": {"effort": "medium"}
}
```

Per disabilitare il ragionamento, usa `{"type":"disabled"}` con livello di impegno low, medium o high. Non includere `display` o `block_binding` nella modalità disabilitata. `enabled`, `budget_tokens`, `between_tools` e il ragionamento disabilitato con xhigh/max non sono validi.

In modalità adattiva, `display` accetta `omitted`, `summarized` o null. Il valore beta generico `updates` richiede `thinking-display-updates-2026-08-18`; Anthropic non conferma attualmente aggiornamenti leggibili sull'avanzamento per Haiku, quindi non fare affidamento su questo output.

Il campo facoltativo `thinking.block_binding` richiede `thinking-binding-controls-2026-08-01`. È null oppure un oggetto il cui `prefix_mismatch_behavior` è `error`, `drop_block` o null. Mantieni invariati i turni precedenti della conversazione e i blocchi completi di ragionamento quando reinvii la cronologia. Le firme del ragionamento sono vincolate all'account che le ha prodotte o a un account collegato.

`output_config.task_budget` è null oppure `{ "type": "tokens", "total": 20000 }` con `remaining` facoltativo, intero o null. Richiede `task-budgets-2026-03-13`; `total` deve essere almeno 20000. Qui non viene imposto un ulteriore intervallo per `remaining`.

### Strumenti e output strutturato [#strumenti-e-output-strutturato]

Gli strumenti client richiedono un nome di 1–128 lettere, cifre, trattini bassi o trattini e un `input_schema` con `type: "object"`. Usa `tool_choice: {"type":"any"}` oppure `{"type":"tool","name":"lookup"}` per forzare uno strumento dichiarato. Con il ragionamento adattivo, una risposta con strumento forzato inizia dalla chiamata allo strumento senza un blocco di ragionamento.

`disable_parallel_tool_use` è un booleano facoltativo per le scelte auto, any e tool; non è un campo di none. Reinvia il risultato dello strumento con il `tool_use_id` originale. La tua applicazione esegue gli strumenti client.

```json
{
  "tools": [{
    "name": "lookup",
    "description": "Look up a product by SKU.",
    "input_schema": {
      "type": "object",
      "properties": {"sku": {"type": "string"}},
      "required": ["sku"],
      "additionalProperties": false
    }
  }],
  "tool_choice": {"type": "tool", "name": "lookup"}
}
```

Le risposte strutturate usano `output_config.format: {"type":"json_schema","schema":{...}}`. Segui il sottoinsieme JSON Schema supportato da Anthropic, incluso `additionalProperties: false` sugli oggetti. Una struttura valida non garantisce valori fattualmente corretti. Gli strumenti rigorosi e l'output strutturato hanno limiti applicati all'intero schema; vedi la [documentazione ufficiale dell'output strutturato](https://platform.claude.com/docs/en/build-with-claude/structured-outputs).

L'uso del computer richiede `computer_toolset_20260801`; le vecchie versioni degli strumenti per computer non sono valide. L'uso del browser ha un proprio `browser_toolset_20260801`. Dichiarare uno strumento non verifica il funzionamento di una sessione completa con strumenti server. Consulta la guida ufficiale dello strumento e gli eventuali requisiti beta prima di usarlo.

## 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 Haiku 5.5

`claude-haiku-5-5`

| Token fatturabili | claude · Predefinito · ≤ 100.000 token di input | claude · Predefinito · > 100.000 token di input |
| --- | ---: | ---: |
| Input (non in cache) | 0,05 USD | 0,25 USD |
| Output | 0,25 USD | 1,25 USD |
| Lettura dalla cache | 0,005 USD | 0,025 USD |
| Scrittura nella cache · 5 minuti | 0,0625 USD | 0,3125 USD |
| Scrittura nella cache · 1 ora | 0,1 USD | 0,5 USD |

La soglia si basa su: Token di input non in cache. La fascia selezionata si applica all'intera richiesta, non solo ai token che superano la soglia.

— 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-haiku-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-haiku-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-haiku-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.

## Riferimenti del modello [#riferimenti-del-modello]

* [Panoramica del modello Haiku 5.5](https://platform.claude.com/docs/en/models/haiku-5-5/overview)
* [Guida alla migrazione a Haiku 5.5](https://platform.claude.com/docs/en/models/haiku-5-5/migration-guide)
* [Documentazione Messages](https://platform.claude.com/docs/en/api/messages/create)
* [Documentazione Beta Messages](https://platform.claude.com/docs/en/api/beta/messages/create)
* [Ragionamento](https://platform.claude.com/docs/en/build-with-claude/thinking), [livello di impegno](https://platform.claude.com/docs/en/build-with-claude/effort), [budget delle attività](https://platform.claude.com/docs/en/build-with-claude/task-budgets)
* [Compattazione su richiesta](https://platform.claude.com/docs/en/build-with-claude/compaction-on-demand), [modifica del contesto](https://platform.claude.com/docs/en/build-with-claude/context-editing)
* [Memorizzazione del prompt nella cache](https://platform.claude.com/docs/en/build-with-claude/prompt-caching), [visione](https://platform.claude.com/docs/en/build-with-claude/vision), [supporto PDF](https://platform.claude.com/docs/en/build-with-claude/pdf-support)
