Usando a API
Versions
Ao fazer solicitações de 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 de cliente, isso será 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 de erro específicos
- Adicionar novas variantes a valores de saída semelhantes a enums (por exemplo, tipos de eventos de streaming)
Geralmente, se você estiver usando a API conforme documentado nesta referência, não interromperemos 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 enviados pelo servidor (SSE) de streaming:
- 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.
- Evento desnecessário
data: [DONE]
removido.
- As conclusões são incrementais. Por exemplo,
- Valores legados
exception
etruncated
removidos nas respostas.
- Novo formato para eventos enviados pelo servidor (SSE) de streaming:
2023-01-01
: Lançamento inicial.