Cabeçalhos beta
Documentação para usar cabeçalhos beta com a API Anthropic
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.
Os cabeçalhos beta são frequentemente usados em conjunto com o namespace beta nos SDKs do cliente
Como usar cabeçalhos beta
Para acessar recursos beta, inclua o cabeçalho anthropic-beta
em suas solicitações de API:
Ao usar o SDK, você pode especificar cabeçalhos beta nas opções de solicitação:
Os recursos beta são experimentais e podem:
- Ter alterações disruptivas sem aviso
- Ser descontinuados ou removidos
- Ter limites de taxa ou preços diferentes
- Não estar disponíveis em todas as regiões
Múltiplos recursos beta
Para usar múltiplos recursos beta em uma única solicitação, inclua todos os nomes de recursos no cabeçalho separados por vírgulas:
Convenções de nomenclatura de versão
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:
Obtendo ajuda
Para perguntas sobre recursos beta:
- Verifique a documentação para o recurso específico
- Revise o changelog da API para atualizações
- Entre em contato com o suporte para assistência com uso em produção
Lembre-se de que os recursos beta são fornecidos “como estão” e podem não ter as mesmas garantias de SLA que os recursos estáveis da API.