ProxyAPI
Вход

Эндпоинт /v1/messages принимает запросы в формате Anthropic Messages. Код, написанный под API Anthropic, переносится без изменений — меняются только базовый адрес и ключ.

Обязательные поля: model, messages и max_tokens — ограничение на длину ответа. Инструкция для модели передаётся отдельным полем system.

Официальные библиотеки Anthropic сами дописывают путь /v1/messages, поэтому в качестве базового адреса им указывается https://api.proxyapi.ru.

curl "https://api.proxyapi.ru/v1/messages" \
    -H "Content-Type: application/json" \
    -H "X-API-Key: <КЛЮЧ>" \
    -d '{
        "model": "anthropic/claude-haiku-4-5",
        "max_tokens": 1024,
        "system": "Отвечай коротко.",
        "messages": [
            {"role": "user", "content": "Назови столицу Австралии."}
        ]
    }'

Ключ передаётся заголовком X-API-Key — так его отправляют официальные библиотеки Anthropic. Заголовок Authorization тоже работает. Заголовок anthropic-version подставляется автоматически, передавать его не нужно.

Если в поле model указано короткое имя без вендора, подставляется anthropic — на этом эндпоинте это вендор по умолчанию.

Текст лежит в массиве content, в элементе с типом text:

{
    "type": "message",
    "role": "assistant",
    "content": [
        {
            "type": "text",
            "text": "Канберра."
        }
    ],
    "usage": {
        "input_tokens": 18,
        "output_tokens": 4
    }
}

Эндпоинт /v1/messages/count_tokens считает, сколько токенов займёт запрос, не выполняя его. Тело запроса — такое же, как у /v1/messages.

Сам формат Anthropic Messages не ограничивает выбор: на /v1/messages можно обратиться к любой текстовой модели каталога, указав её идентификатор целиком — например, deepseek/deepseek-v4-pro, qwen/qwen3.8-flash или openai/gpt-5-mini.

  • Единый API — базовый формат запроса и ответа.
  • Модели — как устроены идентификаторы и что доступно.

Частые вопросы

Подойдёт ли официальная библиотека Anthropic?

Да. Достаточно указать базовый адрес https://api.proxyapi.ru и ключ ProxyAPI — путь /v1/messages библиотека дописывает сама.

Можно ли на этом эндпоинте обращаться к моделям других вендоров?

Да, доступна любая текстовая модель каталога — например deepseek/deepseek-v4-pro или openai/gpt-5-mini. Идентификатор нужно указать целиком, вместе с вендором. А вот подсчёт токенов работает только с моделями Anthropic.

Почему запрос возвращает ошибку про max_tokens?

В формате Anthropic поле max_tokens обязательное, в отличие от формата OpenAI. Укажите в нём предельную длину ответа в токенах.

Последняя редакция: 2 сентября 2026 г.