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 através 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-4-8",
    max_tokens=1024,
    inference_geo="us",
    messages=[
        {"role": "user", "content": "Summarize the key points of this document."}
    ],
)

print(response.content[0].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 Opus 4.6, Claude Sonnet 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 de 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 está 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 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. Acesse 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:

• Claude Opus 4.6, Claude Sonnet 4.6 e posteriores: A inferência somente nos EUA (inference_geo: "us") tem preço de 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"): Aplica-se o preço padrão.
• Modelos mais antigos: Não oferecem suporte a inference_geo (consulte Disponibilidade de modelos); aplica-se o preço 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. Plataformas operadas por parceiros (Bedrock e Vertex AI) têm seus próprios preços regionais. Consulte Preços de residência de dados para mais detalhes.

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 sair do 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 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 de 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 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" 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

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 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