guides

Claude Fable 5.2 API: prezzi, configurazione e codice

Poyo.ai Team
18 min read
Share:

In sintesi

  • ID del modello: claude-fable-5-2. Rilasciato il 9 novembre 2026, con una finestra di contesto da 1M token e fino a 128K token di output per richiesta.
  • Prezzo: $8 / $40 per milione di token di input/output sull’API di Anthropic, il 20% in meno rispetto a Fable 5.1. Su PoYo costa $6.40 / $32.
  • Due modi per chiamarlo su PoYo: il formato Messages di Anthropic su POST https://api.poyo.ai/v1/messages oppure l’endpoint compatibile con OpenAI POST https://api.poyo.ai/v1/chat/completions. Gli SDK ufficiali di Anthropic funzionano impostando l’URL di base su https://api.poyo.ai.
  • Il ragionamento è sempre attivo. Profondità e costo si regolano con output_config.effort. Il valore predefinito è high; per il lavoro di routine usa medium o low.
  • Il ragionamento si paga come output. Anche una risposta breve può consumare migliaia di token di output con impegno high: imposta quindi effort in modo esplicito e dimensiona max_tokens per ragionamento più risposta.
  • Leggi prima stop_reason. Ti dice se il modello ha finito, ha chiamato uno strumento, ha raggiunto max_tokens o ha restituito un refusal di sicurezza: controllalo prima di leggere il contenuto.

Claude Fable 5.2 API in breve

Claude Fable 5.2
ID del modello nell’APIclaude-fable-5-2
Rilascio9 novembre 2026
Finestra di contesto1M token
Output massimo128K token per richiesta
Input → outputTesto e immagini → testo
RagionamentoAdattivo, sempre attivo
Livelli di impegnolow, medium, high (predefinito), xhigh, max
Limite delle conoscenzeGiugno 2026
Conservazione dei datiConservazione per 30 giorni
Prezzo ufficiale (per 1M token)$8 input / $40 output / $0.20 lettura dalla cache
Prezzo su PoYo (per 1M token)$6.40 input / $32 output / $0.16 lettura dalla cache
Endpoint di PoYo/v1/messages, /v1/chat/completions

Anthropic presenta Fable 5.2 come il modello per il ragionamento impegnativo e il lavoro agentico a lungo orizzonte, e consiglia Claude Opus 5.5 come punto di partenza per la maggior parte dei carichi di lavoro. Se stai ancora scegliendo tra i due, leggi prima Claude Fable 5.2 e Opus 5.5 a confronto. Questa guida si concentra sull’integrazione.

Un prototipo di sistema operativo creato da agenti Claude Fable 5.2, in esecuzione su un portatile. Video dai materiali di lancio di Claude Fable 5.2 pubblicati da Anthropic.

Fable 5, 5.1 o 5.2: quale prezzo stai guardando?

Chi cerca «prezzi di Claude Fable 5» può riferirsi a uno qualsiasi dei tre modelli Fable rilasciati nel 2026. Condividono la finestra di contesto da 1M e il limite di 128K token di output, e ognuno ha il proprio prezzo:

ModelloRilascioInputOutputLettura dalla cacheID del modello nell’API
Claude Fable 59 giugno 2026$10$50$1.00claude-fable-5
Claude Fable 5.11° settembre 2026$10$50$0.25claude-fable-5-1
Claude Fable 5.29 novembre 2026$8$40$0.20claude-fable-5-2

Prezzi ufficiali in USD per milione di token. Fable 5.2 è il primo taglio di prezzo nella fascia Fable ed è il modello attuale, quindi i nuovi progetti dovrebbero partire da qui. Il resto della guida riguarda Fable 5.2.

I prezzi in breve

Voce di costo (per 1M token)Ufficiale AnthropicPoYoCrediti PoYo
Input$8.00$6.401.280
Output (ragionamento incluso)$40.00$32.006.400
Lettura dalla cache$0.20$0.1632
Scrittura in cache, 5 minuti$10.00$8.001.600
Scrittura in cache, 1 ora$16.00$12.802.560

PoYo fattura a consumo in crediti, con $1 = 200 crediti e senza abbonamento. L’intera finestra di contesto da 1M è fatturata a prezzo standard, quindi un prompt da 900K token costa per token quanto un prompt da 9K token. Per tutti gli altri modelli Claude, consulta la nostra guida ai prezzi di Claude API.

Avvio rapido

  1. Crea una chiave API nella dashboard di PoYo.
  2. Invia le richieste a https://api.poyo.ai con il modello impostato su claude-fable-5-2.
  3. Autenticati con x-api-key: YOUR_KEY su /v1/messages (funziona anche Authorization: Bearer YOUR_KEY) oppure con Authorization: Bearer YOUR_KEY su /v1/chat/completions.

curl (formato Messages di Anthropic)

curl https://api.poyo.ai/v1/messages \
  -H "x-api-key: $POYO_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-fable-5-2",
    "max_tokens": 16000,
    "output_config": {"effort": "medium"},
    "messages": [
      {"role": "user", "content": "Trova la race condition in questo worker pool Go e proponi una correzione: ..."}
    ]
  }'

La risposta è un oggetto Message standard di Anthropic. La risposta vera e propria si trova nel blocco text di content; può essere preceduta da un blocco thinking.

Python (SDK di Anthropic)

import os
import anthropic

client = anthropic.Anthropic(
    base_url="https://api.poyo.ai",
    api_key=os.environ["POYO_API_KEY"],
)

with client.messages.stream(
    model="claude-fable-5-2",
    max_tokens=32000,
    output_config={"effort": "medium"},
    thinking={"type": "adaptive", "display": "summarized"},
    messages=[{"role": "user", "content": "Scrivi un piano di migrazione da REST a gRPC per questo servizio: ..."}],
) as stream:
    message = stream.get_final_message()

if message.stop_reason == "refusal":
    print("Request declined:", message.stop_details)
else:
    for block in message.content:
        if block.type == "thinking":
            print("Thinking summary:", block.thinking)
        elif block.type == "text":
            print(block.text)

print(message.usage)

Lo streaming tiene le richieste lunghe al riparo dai timeout HTTP. Con impegno high o superiore, una singola richiesta difficile può durare diversi minuti.

TypeScript (SDK di Anthropic)

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  baseURL: "https://api.poyo.ai",
  apiKey: process.env.POYO_API_KEY,
});

const message = await client.messages
  .stream({
    model: "claude-fable-5-2",
    max_tokens: 32000,
    output_config: { effort: "medium" },
    messages: [{ role: "user", content: "Analizza questa pull request alla ricerca di problemi di sicurezza: ..." }],
  })
  .finalMessage();

if (message.stop_reason === "refusal") {
  console.log("Request declined:", message.stop_details);
} else {
  for (const block of message.content) {
    if (block.type === "text") console.log(block.text);
  }
}

Chat Completions compatibile con OpenAI

Se il tuo stack usa già il formato di richiesta di OpenAI, invia lo stesso ID del modello a /v1/chat/completions:

curl https://api.poyo.ai/v1/chat/completions \
  -H "Authorization: Bearer $POYO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-fable-5-2",
    "messages": [
      {"role": "system", "content": "Sei un data engineer senior."},
      {"role": "user", "content": "Progetta uno schema per la deduplicazione degli eventi in ClickHouse."}
    ],
    "stream": true
  }'

Con l’SDK ufficiale di OpenAI, imposta base_url su https://api.poyo.ai/v1. Usa /v1/messages quando ti servono controlli specifici di Claude come output_config.effort, la visualizzazione del ragionamento, cache_control e le definizioni degli strumenti in stile Anthropic.

Livello di impegno: la leva principale su qualità e costi

Fable 5.2 ragiona in modo adattivo a ogni richiesta. L’impostazione effort all’interno di output_config decide quanto:

ImpegnoQuando usarloNote
lowScambi rapidi, attività ben specificate, subagenti ad alto volumeIl più veloce e il più economico. Per le attività lunghe, aggiungi un’istruzione del tipo «porta a termine l’intera attività»
mediumProgrammazione interattiva, chat, lavoro di conoscenza quotidianoUn buon valore predefinito per la maggior parte del traffico di prodotto
high (predefinito)Programmazione difficile, ricerca, lavoro agentico, lunghe esecuzioni autonomeSecondo Anthropic, gran parte del guadagno di capacità è già presente con high
xhighIl lavoro di programmazione e con agenti più difficile e di lunga durataUsalo dove le tue valutazioni mostrano un guadagno misurato; consuma più token
maxMisurare il limite massimo, o rare attività in cui la profondità conta più di tempo e tokenIl ragionamento più profondo e i turni più lunghi

Grafico FrontierCode 2.0 di Anthropic che mette in relazione punteggio e costo per attività, con Claude Fable 5.2 a impegno low, medium, high, xhigh e max accanto ad altri modelli

Come il livello di impegno bilancia punteggio e costo per attività su FrontierCode 2.0. Grafico dai materiali di lancio di Claude Fable 5.2 pubblicati da Anthropic.

Tre regole pratiche:

  • Imposta l’impegno in ogni richiesta. Il codice ripreso da Opus 5.5 girava a medium per impostazione predefinita. Su Fable 5.2 la stessa richiesta gira a high e consuma più token di output.
  • Usa l’impegno per decidere quanto ragiona. Per turni più rapidi ed economici, Anthropic consiglia un livello di impegno più basso al posto di istruzioni nel prompt come «rispondi direttamente senza riflettere». Con high e oltre, Fable 5.2 ragiona prima di quasi ogni risposta, persino un saluto.
  • Usa il prompt per la lunghezza della risposta. L’impegno stabilisce la profondità del ragionamento; il prompt stabilisce quanto è lunga la risposta finale.

Per un esempio misurato dell’effetto dell’impegno sulla fattura, guarda i risultati dei test pratici in Claude Fable 5.2 e Opus 5.5 a confronto: in un’attività di programmazione Fable 5.2 ha ottenuto lo stesso punteggio a medium e a high, con circa un quarto del costo a medium.

Ragionamento adattivo: cosa significa «sempre attivo» per il tuo codice

  • Ometti thinking oppure invia {"type": "adaptive"}. È tutta la configurazione del ragionamento che serve. La profondità dipende da effort, che sostituisce le precedenti impostazioni budget_tokens e disabled.
  • I token di ragionamento si pagano come output e rientrano in max_tokens. Dimensiona max_tokens per ragionamento più risposta: 16K è una buona base, e 32K o più con lo streaming si adatta alle attività difficili.
  • I riepiloghi del ragionamento si attivano su richiesta. Per impostazione predefinita i blocchi di ragionamento arrivano con il campo thinking vuoto, così lo streaming resta veloce. Aggiungi "display": "summarized" per ricevere un riepilogo leggibile. In entrambe le modalità viene fatturato l’intero ragionamento.
  • Lascia gestire il campionamento al modello. Invia le richieste senza temperature, top_p e top_k; Fable 5.2 gestisce il campionamento in autonomia.
  • Leggi usage. output_tokens include già il ragionamento, e output_tokens_details.thinking_tokens ne indica la quota.

Uso degli strumenti

Fable 5.2 accetta per tool_choice i valori auto (predefinito) o none. Quando vuoi che uno strumento venga chiamato, nominalo nel prompt:

{
  "model": "claude-fable-5-2",
  "max_tokens": 16000,
  "output_config": {"effort": "medium"},
  "tools": [
    {
      "name": "get_order_status",
      "description": "Look up an order by its ID and return the shipping status and carrier.",
      "input_schema": {
        "type": "object",
        "properties": {"order_id": {"type": "string"}},
        "required": ["order_id"]
      }
    }
  ],
  "tool_choice": {"type": "auto"},
  "messages": [
    {"role": "user", "content": "Dov’è l’ordine A-1042? Verificalo con get_order_status."}
  ]
}

Quando il modello chiama uno strumento, la risposta termina con stop_reason: "tool_use". Esegui lo strumento, poi invia un blocco tool_result nel messaggio utente successivo. Restituisci invariato l’intero turno dell’assistente, blocchi di ragionamento compresi.

Altre regole utili:

  • Usa auto o none per tool_choice. Per assicurarti che uno strumento venga eseguito, nominalo nel prompt. Quando ti serve un JSON garantito, usa l’output strutturato: output_config.format con uno schema JSON.
  • L’uso del computer passa per il set di strumenti computer_toolset_20260801.
  • Analizza gli input degli strumenti con un parser JSON. Gestisce qualsiasi stile di escape che il modello usi negli argomenti degli strumenti.

Bracci robotici controllati da Claude Fable 5.2 a partire dalle immagini delle telecamere, mentre risolvono un cubo rompicapo. Video dai materiali di lancio di Claude Fable 5.2 pubblicati da Anthropic.

Contesto da 1M e caching dei prompt

La finestra da 1M token contiene circa 555.000 parole inglesi, abbastanza per una grande codebase o una pila di contratti in un’unica richiesta. Fable 5.2 usa il tokenizer introdotto con Claude Opus 4.7, che produce più token per lo stesso testo rispetto ai modelli precedenti alla 4.7: conta quindi i token sui tuoi file prima di pianificare attorno al limite.

Con i prompt lunghi la cache rende al massimo. Su Fable 5.2 una lettura dalla cache costa il 2.5% del prezzo di input ($0.20 contro $8 per milione di token). Su PoYo, aggiungi un cache_control di primo livello e l’ultimo blocco memorizzabile viene messo in cache automaticamente:

{
  "model": "claude-fable-5-2",
  "max_tokens": 16000,
  "cache_control": {"type": "ephemeral", "ttl": "1h"},
  "output_config": {"effort": "medium"},
  "system": "You answer questions about the contract below. Quote clause numbers.\n\n<contract>...</contract>",
  "messages": [
    {"role": "user", "content": "Elenca ogni diritto di recesso e il relativo termine di preavviso."}
  ]
}

Metti prima il contenuto stabile (prompt di sistema, definizioni degli strumenti, il documento) e per ultima la domanda che cambia. In una conversazione a più turni o nel ciclo di un agente, ogni nuovo turno rilegge dalla cache il prefisso precedente. La cache da 5 minuti costa 1.25× il prezzo di input in scrittura e si ripaga dopo una lettura; quella da 1 ora costa 2× e si ripaga dopo due.

Due abitudini mantengono efficaci sia la cache sia il ragionamento del modello da un turno all’altro:

  • Mantieni la cronologia in sola aggiunta. Ogni blocco di ragionamento è legato al prompt di sistema, agli strumenti e ai messaggi che lo precedono. Mantieni fissi system e tools per tutta la conversazione e aggiungi i nuovi turni in fondo a messages. Se modifichi i turni precedenti e reinvii i vecchi blocchi di ragionamento, il controllo del prefisso dell’API segnala la richiesta con il messaggio The block is bound to a different conversation. Per cambiare le istruzioni, avvia una nuova conversazione.
  • Cambia modello quando vuoi. Puoi modificare model tra una richiesta e l’altra nella stessa conversazione. I blocchi di ragionamento di Fable 5.2 vengono letti da Fable 5.2 e Mythos 5.2; quando la conversazione passa a un altro modello, come Opus 5.5, l’API scarta automaticamente quei blocchi, la richiesta va a buon fine e il nuovo modello prosegue con il proprio ragionamento. Ogni modello mantiene la propria cache.

Gestire i rifiuti

Fable 5.2 usa classificatori di sicurezza. Quando uno di essi interrompe una richiesta, la risposta arriva come HTTP 200 con stop_reason: "refusal" e un oggetto stop_details che indica l’area della policy, ad esempio cyber, bio o reasoning_extraction. Il tuo codice dovrebbe:

  1. Controllare stop_reason prima di leggere content, come fanno gli esempi Python e TypeScript qui sopra.
  2. Registrare stop_details.category nei log, per capire quali prompt lo attivano.
  3. Inviare la richiesta a un altro modello, come Opus 5.5, oppure mostrare all’utente un messaggio chiaro.

Per vedere come ha ragionato il modello, richiedi il ragionamento con "display": "summarized". In questo modo il ragionamento resta fuori dal testo della risposta, che è proprio l’ambito coperto dalla categoria reasoning_extraction.

Migrare da Fable 5.1 o da Opus 5.5

ProvenienzaCosa cambia
Claude Fable 5.1Sostituisci l’ID del modello. I prezzi scendono da $10 / $50 a $8 / $40. Il controllo del prefisso ora vale per tutti gli account, quindi mantieni le cronologie in sola aggiunta. Usa computer_toolset_20260801 per l’uso del computer. Con lo strumento advisor, imposta l’advisor su claude-fable-5-2. Ripeti la tua analisi dei livelli di impegno partendo da high
Claude Opus 5.5Il prezzo per token passa da $4 / $20 a $8 / $40; le letture dalla cache restano a $0.20. L’impegno predefinito passa da medium a high, quindi impostalo in modo esplicito. Fable 5.2 applica la conservazione dei dati per 30 giorni. Le regole su ragionamento e tool_choice sono le stesse
Claude Opus 5 o precedentiLascia che il ragionamento si adatti da solo e regolalo con effort al posto di disabled e budget_tokens. Usa tool_choice auto con un’istruzione, oppure l’output strutturato per il JSON. Lascia gestire il campionamento al modello al posto di temperature, top_p e top_k. Dimensiona max_tokens per ragionamento più risposta

Vale la pena rivedere i prompt ereditati dai modelli precedenti. Per le attività lunghe e in più passaggi, Anthropic consiglia di aggiungere al prompt di sistema un’istruzione del tipo «porta a termine l’intera attività», soprattutto con impegno low e medium. Fable 5.2 segue da vicino le regole di stile, quindi allenta i limiti rigidi sulla lunghezza delle frasi scritti per i modelli più vecchi, così la sua prosa resta naturale. Quando cambi il prompt, avvia una nuova conversazione.

Quanto costa una richiesta

I token di output qui sotto includono il ragionamento. Tutti i prezzi sono per milione di token.

ScenarioTokenUfficiale ($8 / $40)PoYo ($6.40 / $32)
Risposta in chat5K di input + 1K di output0.005×8 + 0.001×40 = $0.0800.005×6.4 + 0.001×32 = $0.064 (12.8 crediti)
Revisione del codice50K di input + 8K di output0.05×8 + 0.008×40 = $0.720.05×6.4 + 0.008×32 = $0.576 (115.2 crediti)
Sessione di un agente2M di letture dalla cache + 300K di nuovo input + 150K di output2×0.2 + 0.3×8 + 0.15×40 = $8.802×0.16 + 0.3×6.4 + 0.15×32 = $7.04
Documento da 800K token, prima domanda800K scritti nella cache da 5 minuti + 10K di output0.8×10 + 0.01×40 = $8.400.8×8 + 0.01×32 = $6.72
Stesso documento, domanda successiva800K di letture dalla cache + 10K di output0.8×0.2 + 0.01×40 = $0.560.8×0.16 + 0.01×32 = $0.45

Le righe sul documento mostrano perché la cache è importante: dopo la prima domanda, ogni domanda successiva costa circa un quindicesimo. Nella sessione dell’agente l’output pesa per circa due terzi della fattura, ed è per questo che l’impegno è la prima impostazione da regolare.

Usa Claude Fable 5.2 su PoYo

PoYo ti offre Fable 5.2 a un prezzo inferiore del 20% rispetto alle tariffe ufficiali per token di Anthropic, con alcuni vantaggi pratici in più:

  • Un’unica chiave API per tutti i modelli. Fable 5.2, Opus 5.5, Sonnet 5.5, i modelli GPT e i modelli per immagini, video e audio condividono la stessa chiave e la stessa dashboard.
  • Paghi a consumo. I crediti vengono addebitati per token, senza abbonamento.
  • Entrambi i formati di richiesta. Chiama Fable 5.2 nel formato Messages di Anthropic o nel formato Chat Completions di OpenAI con lo stesso ID del modello.

Prova i prompt nel Playground della pagina del modello Claude Fable 5.2, poi porta lo stesso ID del modello in produzione. Per confrontarlo con la scelta quotidiana predefinita, cambia "model" in claude-opus-5-5 dalla pagina di Claude Opus 5.5, con la stessa chiave.

Domande frequenti

Quanto costa l’API di Claude Fable 5.2?

$8 per milione di token di input e $40 per milione di token di output sull’API di Anthropic, con letture dalla cache a $0.20. Su PoYo lo stesso modello costa $6.40 di input, $32 di output e $0.16 per le letture dalla cache, per milione di token. I token di ragionamento si pagano alla tariffa di output.

Qual è il prezzo di Claude Fable 5?

Claude Fable 5 (giugno 2026) costa $10 / $50 per milione di token di input/output, con letture dalla cache a $1. Fable 5.1 ha mantenuto il prezzo di $10 / $50 e ha ridotto le letture dalla cache a $0.25. Fable 5.2 scende a $8 / $40, con letture dalla cache a $0.20.

Qual è l’ID del modello Claude Fable 5.2?

claude-fable-5-2, esattamente come è scritto. Usalo su /v1/messages o su /v1/chat/completions.

Posso usare l’SDK di Anthropic con PoYo?

Sì. Imposta l’URL di base su https://api.poyo.ai e passa la tua chiave PoYo come chiave API. L’SDK invia x-api-key e anthropic-version al posto tuo, e lo streaming funziona con gli helper di streaming dell’SDK.

Come faccio a far ragionare meno Fable 5.2?

Imposta output_config.effort su low o medium. Il ragionamento adattivo è attivo in ogni richiesta e si adegua al livello di impegno, quindi un livello più basso dà risposte più rapide ed economiche.

Quale livello di impegno dovrei usare?

Parti da medium per il lavoro interattivo e la programmazione di routine, e da high per le attività difficili e di lunga durata degli agenti. Passa a xhigh dove le tue valutazioni mostrano un guadagno, e usa low per le chiamate semplici ad alto volume.

Come viene fatturato il contesto lungo?

L’intera finestra da 1M token è fatturata alla tariffa standard, quindi i prompt lunghi costano per token quanto quelli brevi. Il caching dei prompt riduce ulteriormente il costo della rilettura di un contesto lungo.

Posso cambiare modello o modificare i messaggi a metà conversazione?

Puoi cambiare modello in qualsiasi momento: invia la richiesta successiva con un model diverso e l’API scarta automaticamente i blocchi di ragionamento precedenti dove necessario, così la richiesta va a buon fine. Per le modifiche, mantieni fissi system e tools, aggiungi i nuovi messaggi in fondo e restituisci ogni turno dell’assistente esattamente come lo hai ricevuto; il controllo del prefisso segnala le cronologie i cui turni precedenti sono cambiati dopo la creazione di un blocco di ragionamento. Per cambiare le istruzioni, avvia una nuova conversazione.

In cosa Fable 5.2 è diverso da Mythos 5.2?

Condividono le stesse capacità, specifiche e prezzi. Mythos 5.2 è offerto alle organizzazioni verificate tramite i programmi di Anthropic, come il Cyber Verification Program, mentre Fable 5.2 è aperto a tutti gli sviluppatori.

Share: