Usando a API
Versões
Ao fazer solicitações à API, você deve enviar um cabeçalho de solicitação anthropic-version
. Por exemplo, anthropic-version: 2023-06-01
. Se você estiver usando nossas bibliotecas cliente, isso é tratado automaticamente para você.
Para qualquer versão da API, preservaremos:
- Parâmetros de entrada existentes
- Parâmetros de saída existentes
No entanto, podemos fazer o seguinte:
- Adicionar entradas opcionais adicionais
- Adicionar valores adicionais à saída
- Alterar condições para tipos específicos de erro
- Adicionar novas variantes a valores do tipo enum na saída (por exemplo, tipos de eventos de streaming)
Geralmente, se você estiver usando a API conforme documentado nesta referência, não quebraremos seu uso.
Histórico de versões
Sempre recomendamos usar a versão mais recente da API sempre que possível. Versões anteriores são consideradas obsoletas e podem não estar disponíveis para novos usuários.
2023-06-01
- Novo formato para eventos streaming server-sent (SSE):
- As conclusões são incrementais. Por exemplo,
" Olá"
," meu"
," nome"
," é"
," Claude."
em vez de" Olá"
," Olá meu"
," Olá meu nome"
," Olá meu nome é"
," Olá meu nome é Claude."
. - Todos os eventos são eventos nomeados, em vez de eventos somente de dados.
- Removido evento desnecessário
data: [DONE]
.
- As conclusões são incrementais. Por exemplo,
- Removidos valores legados
exception
etruncated
nas respostas.
- Novo formato para eventos streaming server-sent (SSE):
2023-01-01
: Lançamento inicial.