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 governano questo aspetto:

• Inference geo: Controlla dove viene eseguita l'inferenza del modello, su base per-richiesta. Si imposta tramite il parametro API inference_geo o come impostazione predefinita 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-4-8",
    max_tokens=1024,
    inference_geo="us",
    messages=[
        {"role": "user", "content": "Summarize the key points of this document."}
    ],
)

print(response.content[0].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 Opus 4.6, Claude Sonnet 4.6 e modelli successivi. Le richieste con inference_geo su Claude Opus 4.5, Claude Sonnet 4.5, Claude Haiku 4.5 o modelli precedenti restituiscono un errore 400.



Restrizioni a livello di workspace

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

• allowed_inference_geos: Limita quali geo un workspace può utilizzare. Se una richiesta specifica un inference_geo non presente in questo elenco, l'API restituisce un errore.
• default_inference_geo: Imposta la geo di fallback quando inference_geo viene omesso da una richiesta. Le singole richieste possono sovrascrivere questa impostazione specificando 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 successivamente. Attualmente, "us" è l'unico workspace geo disponibile.

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

1. Vai su Settings > Workspaces.
2. Crea un nuovo workspace.
3. Seleziona il workspace geo.



Prezzi

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

• Claude Opus 4.6, Claude Sonnet 4.6 e successivi: L'inferenza solo negli Stati Uniti (inference_geo: "us") ha un prezzo pari a 1,1x la tariffa standard per tutte le categorie di prezzo dei token (token di input, token di output, scritture in cache e letture dalla cache).
• Routing 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 all'API di Claude (first-party) e a Claude Platform on AWS. Su Claude in Microsoft Foundry, lo stesso moltiplicatore 1,1x si applica ai deployment ospitati su Azure che utilizzano il tipo di deployment US Data Zone Standard. Le piattaforme gestite dai partner (Bedrock e Google Cloud) hanno i propri prezzi regionali. Consulta Prezzi per la residenza dei dati per i dettagli.



Supporto Batch API

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



Migrazione dagli opt-out legacy

Se la tua organizzazione aveva precedentemente effettuato l'opt-out dal routing 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 geo.



Cosa è cambiato

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

• Controllo per 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 policy geo su tutte le chiavi di un workspace.



Cosa è successo al tuo workspace

Il tuo workspace è stato migrato automaticamente:

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



Se vuoi utilizzare il routing globale

Se i tuoi requisiti di residenza dei dati sono cambiati e vuoi sfruttare il routing globale per migliori prestazioni e disponibilità, aggiorna le impostazioni inference geo del tuo workspace per includere "global" nelle geo consentite 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 sui modelli più recenti, consulta Prezzi.



Limitazioni attuali

• Limiti di velocità condivisi: I limiti di velocità sono condivisi tra tutte le geo.
• 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