Résidence des données

Les contrôles de résidence des données vous permettent de gérer où vos données sont traitées et stockées. Deux paramètres indépendants régissent cela :

• Inference geo (géographie d'inférence) : Contrôle où s'exécute l'inférence du modèle, requête par requête. Défini via le paramètre d'API inference_geo ou comme valeur par défaut de l'espace de travail.
• Workspace geo (géographie de l'espace de travail) : Contrôle où les données sont stockées au repos et où le traitement des points de terminaison (comme le transcodage d'images et l'exécution de code) a lieu. Configuré au niveau de l'espace de travail dans la Claude Console.



Inference geo

Le paramètre inference_geo contrôle où s'exécute l'inférence du modèle pour une requête d'API spécifique. Ajoutez-le à n'importe quel appel POST /v1/messages.



Utilisation de l'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)
# Vérifier où l'inférence a réellement été exécutée
print(f"Inference geo: {response.usage.inference_geo}")



Réponse

L'objet usage de la réponse inclut un champ inference_geo indiquant où l'inférence a été exécutée :

{
  "usage": {
    "input_tokens": 25,
    "output_tokens": 150,
    "inference_geo": "us"
  }
}



Disponibilité des modèles

Le paramètre inference_geo est pris en charge sur Claude Opus 4.6, Claude Sonnet 4.6 et les modèles ultérieurs. Les requêtes avec inference_geo sur Claude Opus 4.5, Claude Sonnet 4.5, Claude Haiku 4.5 ou des modèles antérieurs renvoient une erreur 400.



Restrictions au niveau de l'espace de travail

Les paramètres de l'espace de travail permettent également de restreindre les géographies d'inférence disponibles :

• allowed_inference_geos : Restreint les géographies qu'un espace de travail peut utiliser. Si une requête spécifie un inference_geo qui ne figure pas dans cette liste, l'API renvoie une erreur.
• default_inference_geo : Définit la géographie de repli lorsque inference_geo est omis d'une requête. Les requêtes individuelles peuvent remplacer cette valeur en définissant explicitement inference_geo.

Ces paramètres peuvent être configurés via la Console ou l'Admin API sous le champ data_residency.



Workspace geo

Le Workspace geo est défini lors de la création d'un espace de travail et ne peut pas être modifié par la suite. Actuellement, "us" est le seul Workspace geo disponible.

Pour définir le Workspace geo, créez un nouvel espace de travail dans la Console :

1. Accédez à Settings > Workspaces.
2. Créez un nouvel espace de travail.
3. Sélectionnez le Workspace geo.



Tarification

La tarification de la résidence des données varie selon la génération du modèle :

• Claude Opus 4.6, Claude Sonnet 4.6 et ultérieurs : L'inférence limitée aux États-Unis (inference_geo: "us") est facturée à 1,1x le tarif standard pour toutes les catégories de tarification de tokens (tokens d'entrée, tokens de sortie, écritures de cache et lectures de cache).
• Routage global (inference_geo: "global") : La tarification standard s'applique.
• Modèles plus anciens : Ne prennent pas en charge inference_geo (voir Disponibilité des modèles) ; la tarification standard s'applique. Les requêtes qui incluent ce paramètre renvoient une erreur 400.

Cette tarification s'applique à l'API Claude (première partie) et à Claude Platform on AWS. Les plateformes exploitées par des partenaires (Bedrock et Vertex AI) ont leur propre tarification régionale. Consultez Tarification de la résidence des données pour plus de détails.



Prise en charge de l'API Batch

Le paramètre inference_geo est pris en charge sur l'API Batch. Chaque requête d'un lot peut spécifier sa propre valeur inference_geo.



Migration depuis les anciennes options de désactivation

Si votre organisation avait précédemment désactivé le routage global pour maintenir l'inférence aux États-Unis, votre espace de travail a été automatiquement configuré avec allowed_inference_geos: ["us"] et default_inference_geo: "us". Aucune modification de code n'est requise. Vos exigences existantes en matière de résidence des données continuent d'être appliquées via les nouveaux contrôles géographiques.



Ce qui a changé

L'ancienne option de désactivation était un paramètre au niveau de l'organisation qui restreignait toutes les requêtes à une infrastructure basée aux États-Unis. Les nouveaux contrôles de résidence des données remplacent cela par deux mécanismes :

• Contrôle par requête : Le paramètre inference_geo vous permet de spécifier "us" ou "global" sur chaque appel d'API, vous offrant une flexibilité au niveau de la requête.
• Contrôles de l'espace de travail : Les paramètres default_inference_geo et allowed_inference_geos dans la Console vous permettent d'appliquer des politiques géographiques à toutes les clés d'un espace de travail.



Ce qui est arrivé à votre espace de travail

Votre espace de travail a été migré automatiquement :

Toutes les requêtes d'API utilisant des clés de votre espace de travail continuent de s'exécuter sur une infrastructure basée aux États-Unis. Aucune action n'est nécessaire pour maintenir votre comportement actuel.



Si vous souhaitez utiliser le routage global

Si vos exigences en matière de résidence des données ont changé et que vous souhaitez tirer parti du routage global pour de meilleures performances et une meilleure disponibilité, mettez à jour les paramètres de géographie d'inférence de votre espace de travail pour inclure "global" dans les géographies autorisées et définissez default_inference_geo sur "global". Consultez Restrictions au niveau de l'espace de travail pour plus de détails.



Impact sur la tarification

Les anciens modèles ne sont pas affectés par cette migration. Pour la tarification actuelle des modèles plus récents, consultez Tarification.



Limitations actuelles

• Limites de débit partagées : Les limites de débit sont partagées entre toutes les géographies.
• Inference geo : Seules les valeurs "us" et "global" sont disponibles.
• Workspace geo : Seule la valeur "us" est actuellement disponible. Le Workspace geo ne peut pas être modifié après la création de l'espace de travail.



Prochaines étapes