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:

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

Inferência geo

O parâmetro inference_geo controla onde a inferência do modelo é executada para uma solicitaçã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-7",
    max_tokens=1024,
    inference_geo="us",
    messages=[
        {"role": "user", "content": "Summarize the key points of this document."}
    ],
)

print(response.content[0].text)
# Check where inference actually ran
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 do modelo

O parâmetro inference_geo é suportado no Claude Opus 4.6 e em todos os modelos subsequentes. Modelos mais antigos lançados antes do Opus 4.6 não suportam o parâmetro. Solicitações com inference_geo em modelos legados retornam um erro 400.

Restrições no nível do workspace

As configurações do workspace também suportam a restrição de quais geos de inferência estão disponíveis:

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

Essas configurações podem ser configuradas através do Console ou da Admin API sob o 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 Opus 4.6 e mais recente: Inferência apenas nos EUA (inference_geo: "us") é precificada em 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" ou omitido): Preços padrão se aplicam.
• Modelos mais antigos: Os preços existentes permanecem inalterados independentemente das configurações de inference_geo.

Este preço se aplica apenas à Claude API (1P). Plataformas de terceiros (AWS Bedrock, Google Vertex AI) têm seus próprios preços regionais. Consulte a página de preços para detalhes.

Suporte da Batch API

O parâmetro inference_geo é suportado na Batch API. Cada solicitaçã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 participar do roteamento global para manter a inferência nos EUA, seu workspace foi automaticamente configurado 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 através dos novos controles geo.

O que mudou

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

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

O que aconteceu com seu workspace

Seu workspace foi migrado automaticamente:

Todas as solicitaçõ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 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 geo de inferência 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 detalhes.

Impacto de preços

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

Limitações atuais

• Limites de taxa compartilhados: Os limites de taxa são compartilhados em todos os geos.
• Inferência geo: Apenas "us" e "global" estão disponíveis no lançamento. Regiões adicionais serão adicionadas ao longo do tempo.
• Workspace geo: Apenas "us" está disponível atualmente. O workspace geo não pode ser alterado após a criação do workspace.

Próximas etapas