Residência de dados

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

• Inference geo: Controla onde a inferência do modelo é executada, por requisição. Definido por meio do parâmetro de API inference_geo ou como padrão do workspace.
• Workspace geo: 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 realmente foi 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 os modelos Claude 4.6 e posteriores. Requisições com inference_geo no 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 permitem restringir quais inference geos estão disponíveis:

• allowed_inference_geos: Restringe quais geos 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 o geo 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 por meio 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 depois. 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 de acordo com a geração do modelo:

• Modelos Claude 4.6 e posteriores: A inferência somente nos EUA (inference_geo: "us") tem preço de 1,1x a tarifa padrão em todas as categorias de preços de tokens (tokens de entrada, tokens de saída, gravações em 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 à Claude API (primária) e ao Claude Platform on AWS. No Claude no 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 mais detalhes.

O mesmo multiplicador se aplica ao Claude Managed Agents: quando a configuração de modelo de um agente fixa inference_geo em "us", as requisições de modelo em sessões que executam esse agente têm preço de 1,1x a tarifa 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 a partir de opt-outs legados

Se sua organização optou anteriormente 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 de residência de dados existentes continuam sendo aplicados por meio dos novos controles de geo.

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 do workspace: As configurações default_inference_geo e allowed_inference_geos no Console permitem que você aplique políticas de geo em todas as chaves de um workspace.

O que aconteceu com seu workspace

Seu workspace foi migrado automaticamente:

Todas as requisições de API que usam 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" nos geos permitidos e defina default_inference_geo como "global". Consulte Restrições no nível do workspace para mais detalhes.

Impacto nos preços

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

Limitações atuais

• Limites de taxa compartilhados: Os limites de taxa são compartilhados entre todos os geos.
• 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