Residência de dados

Os controles de residência de dados permitem que você gerencie onde seus dados são processados e armazenados. Duas configurações independentes governam isso:

• Inference geo (geografia de inferência): Controla onde a inferência do modelo é executada, por requisição. Definido através do parâmetro de API inference_geo ou como padrão do workspace.
• Workspace geo (geografia do workspace): Controla onde os dados são armazenados em repouso e onde o processamento de endpoint (como transcodificação de imagens e execução de código) acontece. Configurado no nível do workspace no Claude Console.



Inference geo

O parâmetro inference_geo controla onde a inferência do modelo é executada para uma requisição de API específica. Adicione-o a qualquer chamada POST /v1/messages.



Uso da 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)
# Verifique onde a inferência foi realmente executada
print(f"Inference geo: {response.usage.inference_geo}")



Resposta

O objeto usage da resposta inclui um campo inference_geo indicando onde a inferência foi executada:

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



Disponibilidade de modelos

O parâmetro inference_geo é compatível com Claude 4.6 e modelos posteriores. Requisições com inference_geo em Claude Opus 4.5, Claude Sonnet 4.5, Claude Haiku 4.5 ou modelos anteriores retornam um erro 400.



Restrições no nível do workspace

As configurações do workspace também oferecem suporte à restrição de quais geografias de inferência estão disponíveis:

• allowed_inference_geos: Restringe quais geografias um workspace pode usar. Se uma requisição especificar um inference_geo que não esteja nesta lista, a API retorna um erro.
• default_inference_geo: Define a geografia de fallback quando inference_geo é omitido de uma requisição. Requisições individuais podem substituir isso definindo inference_geo explicitamente.

Essas configurações podem ser definidas através do Console ou da Admin API no campo data_residency.



Workspace geo

O Workspace geo é definido quando você cria um workspace e não pode ser alterado posteriormente. Atualmente, "us" é o único workspace geo disponível.

Para definir o workspace geo, crie um novo workspace no Console:

1. Vá para Settings > Workspaces.
2. Crie um novo workspace.
3. Selecione o workspace geo.



Preços

Os preços de residência de dados variam por geração de modelo:

• Claude 4.6 e modelos posteriores: A inferência somente nos EUA (inference_geo: "us") é cobrada a 1,1x a taxa padrão em todas as categorias de preços de tokens (tokens de entrada, tokens de saída, gravações de cache e leituras de cache).
• Roteamento global (inference_geo: "global"): Aplicam-se os preços padrão.
• Modelos mais antigos: Não oferecem suporte a inference_geo (consulte Disponibilidade de modelos); aplicam-se os preços padrão. Requisições que incluem o parâmetro retornam um erro 400.

Esses preços se aplicam à API do Claude (first-party) e ao Claude Platform on AWS. No Claude in Microsoft Foundry, o mesmo multiplicador de 1,1x se aplica a implantações hospedadas no Azure que usam o tipo de implantação US Data Zone Standard. Plataformas operadas por parceiros (Bedrock e Google Cloud) têm seus próprios preços regionais. Consulte Preços de residência de dados para obter detalhes.

O mesmo multiplicador se aplica ao Claude Managed Agents: quando a configuração de modelo de um agente fixa inference_geo como "us", as requisições de modelo em sessões executando esse agente são cobradas a 1,1x a taxa padrão.



Suporte à Batch API

O parâmetro inference_geo é compatível com a Batch API. Cada requisição em um lote pode especificar seu próprio valor de inference_geo.



Migração de opt-outs legados

Se sua organização anteriormente optou por não usar o roteamento global para manter a inferência nos EUA, seu workspace foi configurado automaticamente com allowed_inference_geos: ["us"] e default_inference_geo: "us". Nenhuma alteração de código é necessária. Seus requisitos existentes de residência de dados continuam sendo aplicados através dos novos controles de geografia.



O que mudou

O opt-out legado era uma configuração no nível da organização que restringia todas as requisições à infraestrutura baseada nos EUA. Os novos controles de residência de dados substituem isso por dois mecanismos:

• Controle por requisição: O parâmetro inference_geo permite que você especifique "us" ou "global" em cada chamada de API, oferecendo flexibilidade no nível da requisição.
• Controles de workspace: As configurações default_inference_geo e allowed_inference_geos no Console permitem que você aplique políticas de geografia em todas as chaves de um workspace.



O que aconteceu com seu workspace

Seu workspace foi migrado automaticamente:

Todas as requisições de API usando chaves do seu workspace continuam sendo executadas em infraestrutura baseada nos EUA. Nenhuma ação é necessária para manter seu comportamento atual.



Se você quiser usar o roteamento global

Se seus requisitos de residência de dados mudaram e você deseja aproveitar o roteamento global para melhor desempenho e disponibilidade, atualize as configurações de inference geo do seu workspace para incluir "global" nas geografias permitidas e defina default_inference_geo como "global". Consulte Restrições no nível do workspace para obter detalhes.



Impacto nos preços

Modelos legados não são afetados por esta migração. Para os preços atuais em modelos mais recentes, consulte Preços.



Limitações atuais

• Limites de taxa compartilhados: Os limites de taxa são compartilhados entre todas as geografias.
• Inference geo: Apenas "us" e "global" estão disponíveis.
• Workspace geo: Apenas "us" está disponível atualmente. O Workspace geo não pode ser alterado após a criação do workspace.



Próximos passos