Residenza dei dati

I controlli di 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 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:

• 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 su 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 Claude (first-party) e a Claude Platform on AWS. Le piattaforme gestite dai partner (Bedrock e Vertex AI) hanno i propri prezzi regionali. Consulta Prezzi della 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 disattivato 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 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