Residenza dei dati

I controlli di “data residency” (residenza dei dati) ti consentono di gestire dove i tuoi dati vengono elaborati e archiviati. Due impostazioni indipendenti regolano questo aspetto:

• Inference geo: Controlla dove viene eseguita l’inferenza del modello, per singola richiesta. Si imposta tramite il parametro API inference_geo o come valore predefinito del workspace.
• Workspace geo: Controlla dove i dati vengono archiviati a riposo e dove avviene l’elaborazione degli endpoint (come la transcodifica delle immagini e l’esecuzione del codice). Si configura a livello di workspace nella Claude Console.

Inference geo

Il parametro inference_geo controlla dove viene eseguita l’inferenza del modello per una specifica richiesta API. Aggiungilo a qualsiasi chiamata POST /v1/messages.

Utilizzo dell’API

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    inference_geo="us",
    messages=[
        {"role": "user", "content": "Summarize the key points of this document."}
    ],
)

for block in response.content:
    if block.type == "text":
        print(block.text)
# Verifica dove è stata effettivamente eseguita l'inferenza
print(f"Inference geo: {response.usage.inference_geo}")

Risposta

L’oggetto usage della risposta include un campo inference_geo che indica dove è stata eseguita l’inferenza:

{
  "usage": {
    "input_tokens": 25,
    "output_tokens": 150,
    "inference_geo": "us"
  }
}

Disponibilità dei modelli

Il parametro inference_geo è supportato su Claude 4.6 e sui modelli successivi. Le richieste con inference_geo su Claude Opus 4.5, Claude Sonnet 4.5 (deprecato), Claude Haiku 4.5 o modelli precedenti restituiscono un errore 400.

Restrizioni a livello di workspace

Le impostazioni del workspace supportano anche la restrizione degli inference geo disponibili:

• allowed_inference_geos: Limita gli ambiti geografici che un workspace può usare. Se una richiesta specifica un inference_geo non presente in questo elenco, l’API restituisce un errore.
• default_inference_geo: Imposta l’ambito geografico di riserva quando inference_geo è omesso da una richiesta. Le singole richieste possono sovrascriverlo impostando inference_geo esplicitamente.

Queste impostazioni possono essere configurate tramite la Console o l’Admin API nel campo data_residency.

Workspace geo

Il workspace geo viene impostato quando crei un workspace e non può essere modificato in seguito. Attualmente, "us" è l’unico workspace geo disponibile.

Per impostare il workspace geo, crea un nuovo workspace nella Console:

1. Vai a Workspaces nella Claude Console (platform.claude.com/settings/workspaces).
2. Fai clic su Create workspace per aprire la pagina Create workspace (platform.claude.com/settings/workspaces/new) nella Console.
3. Inserisci un nome, conferma il valore nel campo Workspace geo e fai clic su Create workspace.

Prezzi

I prezzi della residenza dei dati variano in base alla generazione del modello:

• Claude 4.6 e modelli successivi: L’inferenza solo negli Stati Uniti (inference_geo: "us") ha un prezzo pari a 1,1x la tariffa standard in tutte le categorie di prezzo dei token (token di input, token di output, scritture in cache e letture dalla cache). Su Claude Haiku 5.5, il moltiplicatore si applica anche ai prezzi più elevati per i prompt superiori a 100.000 token (vedi Prezzi per contesti lunghi).
• Instradamento globale (inference_geo: "global"): Si applicano i prezzi standard.
• Modelli precedenti: Non supportano inference_geo (vedi Disponibilità dei modelli). Si applicano i prezzi standard. Le richieste che includono il parametro restituiscono un errore 400.

Questi prezzi si applicano alla Claude API (first-party), a Claude Platform on AWS e a Claude Models on Google Cloud (Anthropic managed). Su Claude in Microsoft Foundry, lo stesso moltiplicatore 1,1x si applica alle distribuzioni ospitate su Azure che usano il tipo di distribuzione US Data Zone Standard. Le piattaforme gestite da partner, Claude Models on Google Cloud (Google managed) e Bedrock, hanno i propri prezzi regionali. Consulta Prezzi della residenza dei dati per i dettagli.

Lo stesso moltiplicatore si applica a Claude Managed Agents: quando la configurazione del modello di un agente vincola inference_geo a "us", le richieste al modello nelle sessioni che eseguono quell’agente hanno un prezzo pari a 1,1x la tariffa standard.

Supporto della Batch API

Il parametro inference_geo è supportato sulla Batch API. Ogni richiesta in un batch può specificare il proprio valore di inference_geo.

Migrazione dagli opt-out legacy

Se la tua organizzazione aveva in precedenza scelto di non usare l’instradamento globale per mantenere l’inferenza negli Stati Uniti, il tuo workspace è stato configurato automaticamente con allowed_inference_geos: ["us"] e default_inference_geo: "us". Non sono necessarie modifiche al codice. I tuoi requisiti esistenti di residenza dei dati continuano a essere applicati tramite i nuovi controlli geografici.

Cosa è cambiato

L’opt-out legacy era un’impostazione a livello di organizzazione che limitava tutte le richieste all’infrastruttura con sede negli Stati Uniti. I nuovi controlli di residenza dei dati lo sostituiscono con due meccanismi:

• Controllo per singola richiesta: Il parametro inference_geo ti consente di specificare "us" o "global" su ogni chiamata API, offrendoti flessibilità a livello di richiesta.
• Controlli del workspace: Le impostazioni default_inference_geo e allowed_inference_geos nella Console ti consentono di applicare criteri geografici a tutte le chiavi di un workspace.

Cosa è successo al tuo workspace

Il tuo workspace è stato migrato automaticamente:

Tutte le richieste API che usano chiavi del tuo workspace continuano a essere eseguite su infrastruttura con sede negli Stati Uniti. Non è necessaria alcuna azione per mantenere il comportamento attuale.

Se vuoi usare l’instradamento globale

Se i tuoi requisiti di residenza dei dati sono cambiati e vuoi sfruttare l’instradamento globale per prestazioni e disponibilità migliori, aggiorna le impostazioni di inference geo del tuo workspace per includere "global" negli ambiti geografici consentiti e imposta default_inference_geo su "global". Consulta Restrizioni a livello di workspace per i dettagli.

Impatto sui prezzi

I modelli legacy non sono interessati da questa migrazione. Per i prezzi attuali dei modelli più recenti, consulta Prezzi.

Limitazioni attuali

• Limiti di velocità condivisi: I “rate limit” (limiti di velocità) sono condivisi tra tutti gli ambiti geografici.
• Inference geo: Sono disponibili solo "us" e "global".
• Workspace geo: Attualmente è disponibile solo "us". Il workspace geo non può essere modificato dopo la creazione del workspace.

Passaggi successivi

Disponibilità

La funzionalità Residenza dei dati è disponibile su alcuni modelli e idonea per conservazione zero dei dati e preparazione HIPAA.

Supporto API