Os headers beta permitem que você acesse recursos experimentais e novas capacidades do modelo antes que eles se tornem parte da API padrão.

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

Como usar headers beta

Para acessar recursos beta, inclua o header anthropic-beta em suas requisições à 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 headers beta nas opções da requisição:

from anthropic import Anthropic

client = Anthropic()

response = client.messages.create(
    model="claude-3-5-sonnet-20241022",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Hello, Claude"}
    ],
    extra_headers={
        "anthropic-beta": "beta-feature-name"
    }
)

Recursos beta são experimentais e podem:

  • Ter mudanças significativas sem aviso prévio
  • 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 requisição, inclua todos os nomes dos recursos no header separados por vírgulas:

anthropic-beta: feature1,feature2,feature3

Convenções de nomenclatura de versão

Os nomes dos recursos beta geralmente 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 header 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 questões sobre recursos beta:

  1. Verifique 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 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.