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. Impostato 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). 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 sui modelli Claude 4.6 e 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 limitazione degli 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 il geo di fallback quando inference_geo viene omesso da una richiesta. Le singole richieste possono sovrascriverlo impostando esplicitamente inference_geo.

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 della residenza dei dati variano in base alla generazione del modello:

• Modelli Claude 4.6 e 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).
• 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 alla Claude API (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 della residenza dei dati per i dettagli.

Lo stesso moltiplicatore si applica a Claude Managed Agents: quando la configurazione del modello di un agente fissa inference_geo su "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 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 di residenza dei dati esistenti 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 situata negli Stati Uniti. I nuovi controlli di residenza dei dati la sostituiscono con due meccanismi:

• Controllo per richiesta: Il parametro inference_geo ti consente di specificare "us" o "global" in 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 situata 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 prestazioni e disponibilità migliori, aggiorna le impostazioni di inference geo del tuo workspace per includere "global" tra i 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 "rate limits" (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.

Passaggi successivi