Residenza dei dati

I controlli di residenza dei dati ti permettono di gestire dove i tuoi dati vengono elaborati e archiviati. Due impostazioni indipendenti governano questo:

• Inference geo: Controlla dove viene eseguita l'inferenza del modello, su base per-richiesta. Impostato tramite il parametro API inference_geo o come impostazione predefinita dell'area di lavoro.
• Workspace geo: Controlla dove i dati vengono archiviati a riposo e dove avviene l'elaborazione dell'endpoint (transcodifica di immagini, esecuzione di codice, ecc.). Configurato a livello di area di lavoro nella 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-7",
    max_tokens=1024,
    inference_geo="us",
    messages=[
        {"role": "user", "content": "Summarize the key points of this document."}
    ],
)

print(response.content[0].text)
# Check where inference actually ran
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à del modello

Il parametro inference_geo è supportato su Claude Opus 4.6 e tutti i modelli successivi. I modelli più vecchi rilasciati prima di Opus 4.6 non supportano il parametro. Le richieste con inference_geo su modelli legacy restituiscono un errore 400.

Restrizioni a livello di area di lavoro

Le impostazioni dell'area di lavoro supportano anche la restrizione di quali inference geo sono disponibili:

• allowed_inference_geos: Limita quali geo un'area di lavoro può utilizzare. Se una richiesta specifica un inference_geo non 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 questo impostando inference_geo esplicitamente.

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

Workspace geo

Workspace geo viene impostato quando crei un'area di lavoro e non può essere modificato in seguito. Attualmente, "us" è l'unico workspace geo disponibile.

Per impostare workspace geo, crea una nuova area di lavoro nella Console:

1. Vai a Settings > Workspaces.
2. Crea una nuova area di lavoro.
3. Seleziona il workspace geo.

Prezzi

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

• Claude Opus 4.6 e più recenti: L'inferenza solo negli Stati Uniti (inference_geo: "us") è prezzata a 1,1x il tasso standard in tutte le categorie di prezzi dei token (token di input, token di output, scritture della cache e letture della cache).
• Instradamento globale (inference_geo: "global" o omesso): Si applica il prezzo standard.
• Modelli più vecchi: Il prezzo esistente rimane invariato indipendentemente dalle impostazioni inference_geo.

Questo prezzo si applica solo a Claude API (1P). Le piattaforme di terze parti (AWS Bedrock, Google Vertex AI) hanno i propri prezzi regionali. Vedi la pagina dei prezzi per i dettagli.

Supporto Batch API

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

Migrazione dai legacy opt-out

Se la tua organizzazione ha precedentemente rinunciato all'instradamento globale per mantenere l'inferenza negli Stati Uniti, la tua area di lavoro è stata configurata automaticamente con allowed_inference_geos: ["us"] e default_inference_geo: "us". Non sono richieste modifiche al codice. I tuoi requisiti di residenza dei dati esistenti continuano ad essere applicati tramite i nuovi controlli geo.

Cosa è cambiato

Il legacy opt-out 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 sostituiscono questo con due meccanismi:

• Controllo per-richiesta: Il parametro inference_geo ti consente di specificare "us" o "global" su ogni chiamata API, dandoti flessibilità a livello di richiesta.
• Controlli dell'area di lavoro: Le impostazioni default_inference_geo e allowed_inference_geos nella Console ti permettono di applicare politiche geo su tutte le chiavi in un'area di lavoro.

Cosa è successo alla tua area di lavoro

La tua area di lavoro è stata migrata automaticamente:

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

Se vuoi utilizzare 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 della tua area di lavoro per includere "global" nei geo consentiti e imposta default_inference_geo su "global". Vedi Restrizioni a livello di area di lavoro per i dettagli.

Impatto sui prezzi

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

Limitazioni attuali

• Limiti di velocità condivisi: I limiti di velocità sono condivisi tra tutti i geo.
• Inference geo: Solo "us" e "global" sono disponibili al lancio. Regioni aggiuntive verranno aggiunte nel tempo.
• Workspace geo: Solo "us" è attualmente disponibile. Workspace geo non può essere modificato dopo la creazione dell'area di lavoro.

Passaggi successivi