Visão geral da API
Todos os endpoints que o gateway expõe, o formato que cada um usa e o que retorna.
Três endpoints. Dois formatos de requisição. Uma chave.
| Método | Caminho | Formato | Finalidade |
|---|---|---|---|
| POST | /v1/messages | Anthropic Messages | Conclusão de chat, envelope Anthropic |
| POST | /v1/chat/completions | OpenAI Chat Completions | Conclusão de chat, envelope OpenAI |
| GET | /v1/models | Lista no estilo OpenAI | IDs de modelos que sua chave pode acessar |
Uma descrição legível por máquina está publicada em /openapi.json, e um resumo de todo o site em texto simples está em /llms.txt e /llms-full.txt.
Escolher um endpoint
Eles dão acesso aos mesmos modelos pelo mesmo preço. Escolha conforme o formato que seu cliente já envia — não converta os formatos por conta própria.
| Endpoint | Cabeçalho de autenticação | Estrutura da resposta | Transmissão |
|---|---|---|---|
/v1/messages | x-api-key ou Bearer | content[] array + usage | SSE, content_block_delta eventos |
/v1/chat/completions | Bearer | choices[].message.content | SSE, choices[].delta.content fragmentos |
As estruturas de streaming diferem e não são intercambiáveis. Um cliente desenvolvido para
choices[].delta.content não conseguirá ler nada de um fluxo de Messages. Consulte Transmissão.Cabeçalhos comuns
| Cabeçalho | Aplica-se a | Observações |
|---|---|---|
content-type: application/json | ambos os POSTs | Obrigatório |
x-api-key | Messages | Estilo Anthropic |
Authorization: Bearer | ambos | Estilo OpenAI; também aceito por Messages |
anthropic-version: 2023-06-01 | Messages | Definido automaticamente pelos SDKs da Anthropic |
accept: text/event-stream | ambos | Definido pelos SDKs quando stream é true |