Fast mode (anteprima di ricerca)

La "fast mode" (modalità veloce) offre fino a 2,5 volte più token di output al secondo da Claude Opus 5 e Claude Opus 4.8 a un prezzo premium. Imposta speed: "fast" con l'header beta fast-mode-2026-02-01 nella tua richiesta per attivarla.



Modelli supportati

La fast mode è supportata sui seguenti modelli:

• Claude Opus 5 (claude-opus-5)
• Claude Opus 4.8 (claude-opus-4-8)



Come funziona la fast mode

La fast mode esegue lo stesso modello con una configurazione di inferenza più veloce. Non ci sono cambiamenti nell'intelligenza o nelle capacità.

• Fino a 2,5 volte più token di output al secondo rispetto alla velocità standard
• I vantaggi in termini di velocità si concentrano sugli "output tokens per second" (token di output al secondo), o OTPS, non sul "time to first token" (tempo al primo token), o TTFT
• Stessi pesi e comportamento del modello (non è un modello diverso)
• Compatibile con lo streaming, dove il guadagno in OTPS è più visibile



Utilizzo di base

client = anthropic.Anthropic()

response = client.beta.messages.create(
    model="claude-opus-5",
    max_tokens=4096,
    speed="fast",
    betas=["fast-mode-2026-02-01"],
    messages=[
        {"role": "user", "content": "Refactor this module to use dependency injection"}
    ],
)

for block in response.content:
    if block.type == "text":
        print(block.text)



Prezzi

La fast mode ha un prezzo calcolato come moltiplicatore sulle tariffe standard per l'intera finestra di contesto, incluse le richieste con oltre 200k token di input. La tabella seguente mostra i prezzi della fast mode per i modelli supportati:

I prezzi della fast mode si sommano ad altri modificatori di prezzo:

• I moltiplicatori della cache dei prompt si applicano in aggiunta ai prezzi della fast mode
• I moltiplicatori della residenza dei dati si applicano in aggiunta ai prezzi della fast mode

Per i dettagli completi sui prezzi, consulta la pagina Prezzi.



Limiti di velocità

La fast mode ha un limite di velocità dedicato, separato dai limiti di velocità standard di Opus. Quando il tuo limite di velocità della fast mode viene superato, l'API restituisce un errore 429 con un header retry-after che indica quando la capacità sarà disponibile.

La risposta include header che indicano lo stato del tuo limite di velocità della fast mode:

Per i limiti di velocità specifici per livello, consulta la pagina Limiti di velocità.



Verificare quale velocità è stata utilizzata

L'oggetto usage della risposta include un campo speed che indica quale velocità è stata utilizzata, "fast" o "standard". Richiedere speed: "fast" su un modello che non supporta la fast mode restituisce un errore, così come il superamento dei limiti di velocità o della capacità della fast mode (un 429 o 529). Quando una richiesta con speed: "fast" ha successo, usage.speed è "fast". Se stai utilizzando Claude Opus 4.6 e richiedi la fast mode, il suo comportamento è unico. Invece di restituire un errore come gli altri modelli che non supportano la fast mode, passa silenziosamente alla velocità standard. Sebbene non ci sia alcun errore con Opus 4.6, il campo speed mostra accuratamente "standard".

client = anthropic.Anthropic()

response = client.beta.messages.create(
    model="claude-opus-5",
    max_tokens=1024,
    speed="fast",
    betas=["fast-mode-2026-02-01"],
    messages=[{"role": "user", "content": "Hello"}],
)

print(response.usage.speed)  # "fast" or "standard"

{
  "id": "msg_01XFDUDYJgAACzvnptvVoYEL",
  "type": "message",
  "role": "assistant",
// ...
  "usage": {
    "input_tokens": 8,
    "output_tokens": 12,
    "speed": "fast"
  }
}

Per monitorare l'utilizzo e i costi della fast mode nella tua organizzazione, consulta la Usage and Cost API.



Retry e fallback



Retry automatici

Quando i limiti di velocità della fast mode vengono superati, l'API restituisce un errore 429 con un header retry-after. Gli SDK di Anthropic riprovano automaticamente queste richieste fino a 2 volte per impostazione predefinita (configurabile con max_retries), attendendo il ritardo specificato dal server prima di ogni retry. Poiché la fast mode utilizza un rifornimento continuo di token, il ritardo retry-after è tipicamente breve e le richieste hanno successo una volta che la capacità è disponibile.



Fallback alla velocità standard

Se preferisci ricadere sulla velocità standard anziché attendere la capacità della fast mode, intercetta l'errore di limite di velocità e riprova senza speed: "fast". Imposta max_retries a 0 sulla richiesta fast iniziale per saltare i retry automatici e fallire immediatamente in caso di errori di limite di velocità.

Poiché impostare max_retries a 0 disabilita anche i retry per altri errori transitori (sovraccarico, errori interni del server), gli esempi seguenti riemettono la richiesta originale con i retry predefiniti per quei casi.

client = anthropic.Anthropic()


def create_message_with_fast_fallback(max_retries=0, max_attempts=3, **params):
    try:
        return client.with_options(max_retries=max_retries).beta.messages.create(
            **params
        )
    except anthropic.RateLimitError:
        if params.get("speed") == "fast":
            del params["speed"]
            return create_message_with_fast_fallback(max_retries=max_retries, **params)
        raise
    except (
        anthropic.APIStatusError,
        anthropic.APIConnectionError,
    ) as error:
        if isinstance(error, anthropic.APIStatusError) and error.status_code < 500:
            raise
        if max_attempts > 1:
            return create_message_with_fast_fallback(
                max_retries=max_retries, max_attempts=max_attempts - 1, **params
            )
        raise


message = create_message_with_fast_fallback(
    model="claude-opus-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello"}],
    betas=["fast-mode-2026-02-01"],
    speed="fast",
    max_retries=0,
)



Considerazioni

• Cache dei prompt: Passare tra velocità fast e standard invalida la cache dei prompt. Le richieste a velocità diverse non condividono i prefissi memorizzati nella cache.
• Modelli supportati: La fast mode è supportata su Claude Opus 5 e Claude Opus 4.8. Vedi Modelli supportati.
• TTFT: I vantaggi della fast mode si concentrano sui token di output al secondo (OTPS), non sul tempo al primo token (TTFT).
• Batch API: La fast mode non è disponibile con la Batch API.
• Priority Tier: La fast mode non è disponibile con un impegno Priority Tier.
• Claude Platform su AWS: La fast mode non è attualmente disponibile su Claude Platform su AWS.



Passaggi successivi