LogoDocumentazione Wan API
Pagina iniziale
X (Twitter)
Pagina iniziale

Per iniziare

PanoramicaGuida all’integrazioneControlla il saldoElimina un’attività

Modelli Wan

Wan 3.0Wan 3.0 PrimeWan 3.0 ProWan 3.0 Prime Pro

Modelli Seedance

Seedance 2.5Seedance 2.5 FlashSeedance 2.0Seedance 2.0 FastSeedance 2.0 Mini

Modelli per immagini

Seedream 5.0 ProAPI Seedream 5.5

Modelli linguistici

API ClaudeClaude Haiku 5.5Claude Sonnet 5.5Claude Opus 5.5Claude Fable 5.2API GPTGPT Luna 6GPT Terra 6.1GPT Sol 6.1GPT Astra 6
X (Twitter)

API Claude Sonnet 5.5

API Claude Sonnet 5.5: ragionamento adattivo o tra strumenti, limiti dei parametri, streaming e prezzi di input, output e cache per gruppo.

Questa documentazione descrive Claude Sonnet 5.5 e i suoi parametri Messages. Usa claude-sonnet-5-5 con POST https://api.wanapi.app/v1/messages. Confronta i modelli Claude.

Impostazioni del modello

ImpostazioneClaude Sonnet 5.5
ID del modelloclaude-sonnet-5-5
Finestra di contesto1M token
Output sincrono massimo128000 token, incluso il ragionamento
Modalità di ragionamentoAdattivo o between_tools
Livello di impegno predefinitohigh
Chiamate forzate agli strumenti (any / tool)Non supportate

Connessione e invio di una richiesta

Crea una chiave nelle impostazioni delle chiavi API. 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.

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-sonnet-5-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Explain the purpose of a database index in three sentences."}]
  }'
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-sonnet-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

La tabella seguente descrive il contratto nativo di questo modello. Wan API inoltra attualmente le richieste tramite un livello di compatibilità. 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

ParametroTipo / obbligatorietàVincoli e valori predefiniti ufficiali
modelstringa, obbligatorioclaude-sonnet-5-5.
max_tokensintero, obbligatorio0–128000, inclusi i token di ragionamento. Nell'API ufficiale, 0 popola la cache del prompt senza generare output; vedi la sezione Supporto attuale dell'API.
messagesarray di oggetti, obbligatorioAlmeno un messaggio di conversazione, massimo 100000. Ognuno ha role e content; il contenuto è una stringa o un array di blocchi di contenuto. I turni ordinari usano user/assistant. I messaggi system durante la conversazione seguono le regole ufficiali di posizionamento.
systemstringa o array di blocchi di testoIstruzioni al livello principale. I blocchi di testo possono includere punti di interruzione della cache.
thinkingoggettoPredefinito: {"type":"adaptive"}. L'altra modalità supportata è {"type":"between_tools"}. I budget manuali e disabled vengono rifiutati.
thinking.displayenumSolo modalità adattiva: omitted (predefinito) o summarized. L'omissione del riepilogo non significa che il ragionamento sia disabilitato.
thinking.block_bindingoggetto, betaSolo modalità adattiva. Richiede thinking-binding-controls-2026-08-01; segui il contratto ufficiale per la conservazione del ragionamento.
output_config.effortenum o nulllow, medium, high, xhigh, max; predefinito high. Null mantiene il valore predefinito.
output_config.formatoggetto o nullOutput JSON strutturato: {"type":"json_schema","schema":{...}}. Usa il sottoinsieme JSON Schema supportato.
streambooleanoPredefinito false; true restituisce eventi SSE.
stop_sequencesarray di stringheNell'API ufficiale arresta la generazione quando una stringa corrisponde. Il controllo di compatibilità a monte non ha applicato questo comportamento.
temperaturenumero o nullÈ accettato solo 1 per compatibilità; omettilo. Gli altri valori non null vengono rifiutati.
top_pnumero o nullSono accettati solo valori 0.99–1 per compatibilità; omettilo.
top_knessun valore non nullIl campionamento non è supportato; ometti questa proprietà.
toolsarray di oggettiGli strumenti client hanno name, input_schema e impostazioni facoltative di descrizione / convalida rigorosa. Gli strumenti server usano le rispettive definizioni ufficiali con versione.
tool_choiceoggettoauto (predefinito) o none. any e tool forzato con nome vengono rifiutati. auto può includere disable_parallel_tool_use.
metadata.user_idstringa o nullMassimo 512 caratteri; usa un identificatore opaco.
cache_controloggetto o nulltype: "ephemeral"; ttl: "5m" (predefinito) o "1h". Sonnet 5.5 richiede almeno 512 token memorizzabili nella cache. L'API ufficiale supporta anche punti di interruzione della cache a livello di blocco.
diagnosticsoggetto o nullprevious_message_id: stringa di massimo 256 caratteri o null. Richiede la diagnostica della divergenza della cache.
service_tierenumauto (predefinito) o standard_only.
speedenum o nullOmetti oppure usa standard / null. Sonnet 5.5 non supporta fast.
inference_geostringa o nullIl valore predefinito ufficiale proviene dalle impostazioni dell'account. La sola accettazione di una richiesta non verifica l'area geografica di elaborazione.
fallbacksstringa, array di oggetti o null, beta"default" o fino a tre voci di fallback. Ognuna richiede model; le sostituzioni facoltative sono max_tokens, thinking, output_config e speed. Vedi le regole di fallback di seguito.
fallback_credit_tokenstringa, oggetto o nullUn token da un rifiuto precedente oppure {"token":"...","mode":"strict"}. La forma oggetto richiede fallback-credit-2026-07-01; la modalità è strict (predefinita) o best_effort. Non può accompagnare un valore fallbacks non null.
containerstringa, oggetto o nullID del contenitore oppure configurazione con id e skills facoltativi (massimo 20). Le skill usano i campi ufficiali di tipo, identificatore e versione.
context_managementoggetto o nullConfigurazione ufficiale delle modifiche al contesto, incluso edits; null omette l'impostazione. Restano applicabili i vincoli di compatibilità delle modifiche per il modello.
mcp_serversarray di oggettiDefinizioni ufficiali dei server MCP, soggette alla versione beta richiesta e all'autenticazione del server. Una prova con array vuoto non verifica l'esecuzione MCP remota.
compactionoggetto o null, beta{"type":"summarize"}, con compact-2026-09-04; null omette la compattazione. La compattazione attiva non può essere combinata con context_management non null, sequenze di arresto o formato di output strutturato. Il comportamento della compattazione firmata non ha superato il test attuale.
messages[].output_config.effortenum, betaLivello di impegno per messaggio su un messaggio di sistema; richiede mid-conversation-output-config-2026-07-01. I messaggi di sistema contenenti solo il livello di impegno possono apparire ovunque; i gruppi di sistema con contenuto seguono le regole ufficiali di posizionamento. Non deve modificare il livello di impegno in modalità between_tools.

Ragionamento e strumenti

between_tools accetta solo la proprietà type e il livello di impegno low, medium o high. Non inviare display, budget_tokens o block_binding insieme a 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."}]
}

La precompilazione della risposta dell'assistente non è supportata. Per proseguire un pause_turn, reinvia invariato il contenuto dell'assistente restituito dallo strumento server. La compattazione riassume la cronologia esistente e non è una precompilazione dell'assistente. Conserva esattamente i blocchi di ragionamento e le firme; non trasferirli tra modelli e non modificare la cronologia precedente senza seguire le regole ufficiali di associazione.

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

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:

{"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

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 Sonnet 5.5

claude-sonnet-5-5

Claude Sonnet 5.5 — USD per 1 milione di token
Token fatturabiliclaude · Predefinito
Tutte le lunghezze dell'input
Input (non in cache)1 USD
Output5 USD
Lettura dalla cache0,05 USD
Scrittura nella cache · 5 minuti1,25 USD
Scrittura nella cache · 1 ora2 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

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:

{
  "id": "msg_example",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-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

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.

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

Log di utilizzo ed errori

I log LLM 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-sonnet-5-5. Usa i log delle attività per immagini e video.

Esamina lo stato HTTP e l'oggetto error quando una richiesta non riesce. Verifica la chiave, il saldo, 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

  • Panoramica ufficiale di Sonnet 5.5
  • Novità e restrizioni di Sonnet 5.5
  • Documentazione dei parametri Messages
  • Livello di impegno per messaggio
  • Compattazione su richiesta
  • Rifiuti e fallback
  • Credito di fallback

Claude Haiku 5.5

API Claude Haiku 5.5: ragionamento adattivo o disabilitato, strumenti forzati, parametri, streaming e prezzi dei token per gruppo.

Claude Opus 5.5

API Claude Opus 5.5: ragionamento adattivo, impegno medium predefinito, parametri, streaming e prezzi dei token per gruppo.

Indice

Impostazioni del modelloConnessione e invio di una richiestaSupporto attuale dell'APIParametriRagionamento e strumentiInput multimedialiPrezziRisposta e streamingFormati compatibili con OpenAILog di utilizzo ed erroriRiferimenti del modello