HTTP 401
Проверьте x-api-key. Bearer-заголовок относится к OpenAI-совместимым маршрутам.
Доступно
Messages API: Anthropic-совместимое подключение
Рабочая настройка POST /v1/messages: x-api-key, anthropic-version, messages, max_tokens, streaming, tool_use и диагностика клиентов.
API Токенмоста работает
Базовый адрес — https://tokenmost.ru/v1. Создайте ключ в личном кабинете, выберите модель в каталоге и отправьте первый запрос. Методы, которые ещё не доступны, отмечены отдельно.
Как это устроено
Messages API предназначен для клиентов с настраиваемым Anthropic-совместимым endpoint. В отличие от OpenAI-форматов ключ передаётся в x-api-key, а заголовок anthropic-version и целочисленный max_tokens обязательны.
Что потребуется
- Клиент, который позволяет указать собственный Anthropic base URL.
- Положительный баланс, текстовый API-ключ и совместимая модель.
- Проверка того, не добавляет ли клиент /v1 или /messages повторно.
Порядок работы
- Укажите базовый адрес https://tokenmost.ru и путь POST /v1/messages.
- Передайте x-api-key, anthropic-version: 2023-06-01 и Idempotency-Key.
- Отправьте model, messages и обязательный max_tokens.
- Прочитайте текстовые блоки content и usage из успешного ответа.
- Streaming и tool_use проверяйте отдельными короткими запросами.
Пример запроса
Укажите TOKENMOST_BASE_URL=https://tokenmost.ru/v1, ключ проекта и точный ID модели из каталога. Пример отправляет запрос в публичный API и может списать средства с баланса по тарифу модели.
curl "https://tokenmost.ru/v1/messages" \
-H "x-api-key: $TOKENMOST_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: messages-example-0001" \
-d '{
"model": "MODEL_ID_FROM_CATALOG",
"max_tokens": 128,
"messages": [{"role": "user", "content": "Что такое API?"}]
}'Что учесть
Совместимость охватывает опубликованный контракт Токенмоста, а не все возможности официального Anthropic API. Неподдерживаемое поле вернёт 400.
Авторизация и адрес
Не используйте Authorization: Bearer для Messages. Если приложение просит base URL, выясните, добавляет ли оно /v1/messages самостоятельно: двойной путь приведёт к 404.
Блоки content
Ответ содержит массив типизированных блоков. Не предполагайте, что content всегда строка: текст, tool_use и другие поддерживаемые элементы разбираются по полю type.
Tool use
Модель формирует tool_use, приложение исполняет разрешённый инструмент и возвращает tool_result. Сервис не запускает инструменты вместо клиента.
Ошибки и диагностика
HTTP 400 без max_tokens
Messages требует положительный целочисленный max_tokens в пределах лимита модели.
HTTP 404
Уберите повторяющиеся /v1 или /messages из base URL и пути клиента.
Клиент не понимает ответ
Разбирайте content как массив блоков по type, а не как одну строку.
Tool use зациклился
Проверьте tool_use_id, структуру tool_result и ограничьте число агентных шагов.