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 Fable 5.2

API Claude Fable 5.2: ragionamento adattivo, impegno high predefinito, parametri nativi, requisiti beta e prezzi dei token per gruppo.

Questa documentazione descrive Claude Fable 5.2 e i suoi parametri Messages. Usa claude-fable-5-2 con POST https://api.wanapi.app/v1/messages. Confronta i modelli Claude.

Impostazioni del modello

ImpostazioneClaude Fable 5.2
ID del modelloclaude-fable-5-2
Finestra di contesto1M token
Output sincrono massimo128000 token, incluso il ragionamento
Modalità di ragionamentoAdattivo, sempre attivo
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-fable-5-2",
    "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-fable-5-2",
    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

CampoTipo / valore predefinitoVincolo
modelStringa obbligatoriaclaude-fable-5-2. Usa l'ID esatto; il raggruppamento è automatico.
max_tokensIntero obbligatorio0–128000, incluso il ragionamento. Zero non può accompagnare stream true, output strutturato o strumenti forzati.
messagesArray obbligatorio1–100000 turni ufficiali; vuoto solo per proseguire un thread dopo pause_turn.
systemStringa o array di blocchi di testoDa omettere del tutto quando si prosegue un thread.
thinkingOggetto, adattivo per impostazione predefinitaSolo adaptive. display: omitted (predefinito), summarized, updates o null.
output_configOggettoeffort: low, medium, high (predefinito), xhigh, max o null. format e task_budget facoltativi.
output_formatOggetto o nullAlias obsoleto per l'output strutturato; preferisci output_config.format.
stop_sequencesArray di stringheNon accetta null; incompatibile con la compattazione su richiesta.
streamBooleano, falseSSE se true; non accetta null.
toolsArrayStrumenti client e strumenti/set di strumenti server ufficiali. Gli strumenti client vengono eseguiti dalla tua applicazione.
tool_choiceOggettoauto o none; le chiamate forzate agli strumenti vengono rifiutate.
metadataOggettouser_id stringa o null, fino a 512 caratteri.
cache_controlOggetto o nulltype ephemeral, ttl 5m o 1h.
containerStringa, oggetto o nullid facoltativo e fino a 20 skill.
context_managementOggetto o nullModifiche ufficiali al contesto; richiede la beta appropriata.
mcp_serversArrayFino a 20 server HTTPS; richiede la beta MCP appropriata.
diagnosticsOggetto o nullprevious_message_id stringa o null, fino a 256 caratteri.
service_tierauto o standard_onlyFacoltativo; non accetta null.
inference_geoStringa o nullglobal o us, secondo la disponibilità dell'account.
speedStringa o nullstandard, fast o null; fast non richiede beta.
compactionOggetto o nulltype summarize, instructions facoltative fino a 16384 caratteri Unicode.
fallbacksdefault, array o nullFino a tre destinazioni distinte; richiede la beta ufficiale server-side-fallback.
fallback_credit_tokenStringa, oggetto o nullToken fino a 2048 caratteri; richiede la beta ufficiale del credito; non può accompagnare fallbacks.
threadOggetto o nullcreate, oppure continue con previous_message_id; richiede message-threads-2026-08-12.

Ragionamento e strumenti

Claude Fable 5.2 usa il ragionamento adattivo con livello di impegno high per impostazione predefinita. Non supporta il ragionamento enabled, disabled o between_tools, né budget_tokens. thinking.display: updates richiede thinking-display-updates-2026-08-18. thinking.block_binding consente prefix_mismatch_behavior error, drop_block o null con thinking-binding-controls-2026-08-01.

output_config.task_budget richiede task-budgets-2026-03-13, type tokens, total intero di almeno 20000 e remaining facoltativo, intero non negativo. Ometti remaining quando usi la compattazione o reinvii un blocco di compattazione firmato. La compattazione su richiesta richiede compact-2026-09-04 e non può accompagnare context_management, stop_sequences, output strutturato o strumenti forzati. La compattazione a soglia usa compact-2026-01-12, con un trigger input_tokens di almeno 50000.

Il livello di impegno per messaggio sui messaggi di sistema richiede mid-conversation-output-config-2026-07-01. La precompilazione finale dell'assistente viene rifiutata; restano valide le continuazioni ufficiali di pause_turn e compattazione.

Usa computer_toolset_20260801 per l'uso del computer. Gli strumenti Advisor richiedono advisor-tool-2026-03-01 e una destinazione supportata. La tua applicazione controlla l'esecuzione degli strumenti e le autorizzazioni.

La continuazione di un thread invia solo i nuovi messaggi e deve omettere system e tools. Non può accompagnare la compattazione o modifiche al contesto diverse dalla conservazione di tutto il ragionamento. Lo stato scade dopo cinque minuti senza richieste; conserva la conversazione localmente. I vincoli dipendenti dallo stato vengono verificati al momento della continuazione.

Le destinazioni di fallback di Fable 5.2 sono Claude Opus 4.8 e Claude Opus 5. L'esecuzione delle beta avanzate e la fatturazione in modalità veloce richiedono verifiche dal vivo; lo schema della richiesta non garantisce capacità effettivamente misurate.

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 Fable 5.2

claude-fable-5-2

Claude Fable 5.2 — USD per 1 milione di token
Token fatturabiliclaude · Predefinito
Tutte le lunghezze dell'input
Input (non in cache)4 USD
Output20 USD
Lettura dalla cache0,1 USD
Scrittura nella cache · 5 minuti5 USD
Scrittura nella cache · 1 ora8 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-fable-5-2",
  "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-fable-5-2","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-fable-5-2. 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 del modello
  • Documentazione Messages
  • Ragionamento

Claude Opus 5.5

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

API GPT

GPT Luna 6, Terra 6.1, Sol 6.1 e Astra 6: API OpenAI Responses e Chat Completions, ID dei modelli, ragionamento e prezzi aggiornati dei token.

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