Residenza dei dati

I controlli di "data residency" (residenza dei dati) ti permettono 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, 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). Configurato 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",
    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 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 di quali inference geo sono 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 il geo di fallback quando inference_geo viene omesso da una richiesta. Le singole richieste possono sovrascrivere questa impostazione specificando esplicitamente inference_geo.

Queste impostazioni possono essere configurate tramite la Console o l'Admin API sotto il 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 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 4.6 e modelli successivi: L'inferenza solo negli Stati Uniti (inference_geo: "us") ha un prezzo pari a 1,1 volte 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 più vecchi: 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) e a Claude Platform on AWS. Su Claude in Microsoft Foundry, lo stesso moltiplicatore di 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 per la 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 scelto di non utilizzare il 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 richieste 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 permette 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 permettono di applicare politiche 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 tuo 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 di inference geo del tuo workspace per includere "global" nei geo 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 limiti di velocità sono condivisi tra tutti i 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.



Prossimi passi