Обзор API
Все эндпоинты шлюза: какой формат они используют и что возвращают.
Три конечные точки. Два формата запросов. Один ключ.
| Метод | Путь | Формат | Назначение |
|---|---|---|---|
| POST | /v1/messages | Anthropic Messages | Генерация ответа в чате, структура Anthropic |
| POST | /v1/chat/completions | OpenAI Chat Completions | Завершение чата, структура ответа OpenAI |
| GET | /v1/models | Список в формате OpenAI | Идентификаторы моделей, доступных вашему ключу |
Машиночитаемое описание опубликовано по адресу /openapi.json, а текстовая сводка всего сайта — по адресу /llms.txt и /llms-full.txt.
Выбор эндпоинта
Они предоставляют доступ к одним и тем же моделям по одной и той же цене. Выбирайте по формату, который уже отправляет ваш клиент, — не преобразуйте форматы самостоятельно.
| Эндпоинт | Заголовок авторизации | Структура ответа | Потоковая передача |
|---|---|---|---|
/v1/messages | x-api-key или Bearer | content[] массив + usage | SSE, content_block_delta события |
/v1/chat/completions | Bearer | choices[].message.content | SSE, choices[].delta.content фрагменты |
Структуры потоковых ответов различаются и не взаимозаменяемы. Клиент, написанный для
choices[].delta.content не сможет прочитать ничего из потока Messages. См. Потоковая передача.Общие заголовки
| Заголовок | Применяется к | Примечания |
|---|---|---|
content-type: application/json | обоим POST-запросам | Обязательно |
x-api-key | Messages | Формат Anthropic |
Authorization: Bearer | обоим | Формат OpenAI; также принимается в Messages |
anthropic-version: 2023-06-01 | Messages | Устанавливается автоматически SDK Anthropic |
accept: text/event-stream | обоим | Устанавливается SDK, когда stream имеет значение true |