Cabeçalhos beta

Os cabeçalhos beta permitem que você acesse recursos experimentais e novas capacidades de modelo antes que se tornem parte da API padrão.

Esses recursos estão sujeitos a alterações e podem ser modificados ou removidos em versões futuras.



Como usar cabeçalhos beta

Para acessar recursos beta, inclua o cabeçalho anthropic-beta em suas requisições de API:

POST /v1/messages
Content-Type: application/json
X-API-Key: YOUR_API_KEY
anthropic-beta: BETA_FEATURE_NAME

Ao usar o SDK, você pode especificar cabeçalhos beta nas opções da requisição:

client = Anthropic()

response = client.beta.messages.create(
    model="claude-opus-4-8",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, Claude"}],
    betas=["files-api-2025-04-14"],
)



Múltiplos recursos beta

Para usar múltiplos recursos beta em uma única requisição, inclua todos os nomes de recursos no cabeçalho separados por vírgulas:

anthropic-beta: feature1,feature2,feature3



Cabeçalhos específicos de endpoint

Alguns recursos beta têm escopo limitado a endpoints específicos em vez de parâmetros individuais de requisição e exigem um cabeçalho beta específico do recurso em cada requisição:

Consulte a visão geral de Managed Agents e a referência de túneis MCP para mais detalhes.



Convenções de nomenclatura de versões

Os nomes de recursos beta normalmente seguem o padrão: feature-name-YYYY-MM-DD, onde a data indica quando a versão beta foi lançada. Sempre use o nome exato do recurso beta conforme documentado.



Tratamento de erros

Se você usar um cabeçalho beta inválido ou indisponível, receberá uma resposta de erro:

{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "Unsupported beta header: invalid-beta-name"
  }
}



Obtendo ajuda

Para dúvidas sobre recursos beta:

1. Consulte a documentação do recurso específico
2. Revise o changelog da API para atualizações
3. Entre em contato com o suporte para assistência com uso em produção

Lembre-se de que os recursos beta são fornecidos "no estado em que se encontram" e podem não ter as mesmas garantias de SLA que os recursos estáveis da API.