Résidence des données

Les contrôles de « data residency » (résidence des données) vous permettent de gérer l'endroit où vos données sont traitées et stockées. Deux paramètres indépendants régissent cela :

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

Inference geo

Le paramètre inference_geo contrôle l'endroit où s'exécute l'inférence du modèle pour une requête 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-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)
# Vérifier où l'inférence s'est réellement 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 s'est 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 les modèles Claude 4.6 et 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 zones géographiques d'inférence disponibles :

• allowed_inference_geos : restreint les zones géographiques 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 zone géographique 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

La Workspace geo est définie lorsque vous créez un espace de travail et ne peut pas être modifiée par la suite. Actuellement, "us" est la seule Workspace geo disponible.

Pour définir la 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 la Workspace geo.

Tarification

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

• Modèles Claude 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 des jetons (jetons d'entrée, jetons de sortie, écritures en cache et lectures en 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 le paramètre renvoient une erreur 400.

Cette tarification s'applique à la Claude API (première partie) et à Claude Platform on AWS. Sur Claude dans Microsoft Foundry, le même multiplicateur de 1,1x s'applique aux déploiements hébergés sur Azure qui utilisent le type de déploiement US Data Zone Standard. Les plateformes exploitées par des partenaires (Bedrock et Google Cloud) ont leur propre tarification régionale. Consultez Tarification de la résidence des données pour plus de détails.

Le même multiplicateur s'applique à Claude Managed Agents : lorsque la configuration de modèle d'un agent épingle inference_geo sur "us", les requêtes de modèle dans les sessions exécutant cet agent sont facturées à 1,1x le tarif standard.

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 auparavant 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 la remplacent par deux mécanismes :

• Contrôle par requête : le paramètre inference_geo vous permet de spécifier "us" ou "global" à chaque appel 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 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 conserver 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 profiter du routage global pour de meilleures performances et une meilleure disponibilité, mettez à jour les paramètres de zone géographique d'inférence de votre espace de travail pour inclure "global" dans les zones géographiques 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 zones géographiques.
• Inference geo : seules "us" et "global" sont disponibles.
• Workspace geo : seule "us" est actuellement disponible. La Workspace geo ne peut pas être modifiée après la création de l'espace de travail.

Étapes suivantes