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:

• Geo de inferência: 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.
• Geo do workspace: 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.

Geo de inferência

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

curl https://api.anthropic.com/v1/messages \
    --header "x-api-key: $ANTHROPIC_API_KEY" \
    --header "anthropic-version: 2023-06-01" \
    --header "content-type: application/json" \
    --data '{
        "model": "claude-opus-4-6",
        "max_tokens": 1024,
        "inference_geo": "us",
        "messages": [{
            "role": "user",
            "content": "Summarize the key points of this document."
        }]
    }'

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.

Geo do workspace

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

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

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

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 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" 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, Microsoft Foundry) têm seus próprios preços regionais. Consulte a página de preços para detalhes.

Suporte da API em lote

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 de 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 de solicitaçã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 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ê quer 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 para "global". Consulte Restrições no nível do workspace para detalhes.

Impacto de preço

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.
• Geo de inferência: Apenas "us" e "global" estão disponíveis no lançamento. Regiões adicionais serão adicionadas ao longo do tempo.
• Geo do workspace: Apenas "us" está disponível no momento. O geo do workspace não pode ser alterado após a criação do workspace.

Próximas etapas