Миграция с прежних эндпоинтов ProxyAPI

Раньше у каждого конечного сервиса был свой адрес: отдельный для моделей OpenAI, отдельный для Anthropic, отдельный для Google. Теперь все модели каталога доступны по одному адресу — единому API.

Переход сводится к замене базового адреса. Ключ, структура запроса и ответа, идентификаторы моделей и пути после базового адреса остаются прежними.

Какой адрес на какой меняется

Путь после базового адреса не меняется. Запрос, который уходил на /openai/v1/chat/completions, теперь уходит на /v1/chat/completions; /anthropic/v1/messages становится /v1/messages; /google/v1beta/models/gemini-2.5-flash:generateContent — /v1beta/models/gemini-2.5-flash:generateContent.

Что поменять в коде

В официальных библиотеках меняется одна строка — базовый адрес:

curlpythonnode.js
curl "https://api.proxyapi.ru/v1/chat/completions" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <КЛЮЧ>" \
    -d '{
        "model": "gpt-5-mini",
        "messages": [
            {"role": "user", "content": "Привет!"}
        ]
    }'

То же самое с библиотекой Anthropic — base_url меняется на https://api.proxyapi.ru, обращения идут на /v1/messages. С библиотекой Google меняется только адрес, метод generateContent остаётся прежним.

Идентификаторы моделей

Короткие имена работают как раньше. Вендор подставляется по эндпоинту, на который пришёл запрос:

Это режим совместимости, сделанный ради миграции: благодаря ему замена адреса не тянет за собой правку идентификаторов. Отключать его не планируется, но полагаться на него не стоит. Короткое имя привязано к эндпоинту: тот же claude-haiku-4-5 на /v1/chat/completions превратится в несуществующую openai/claude-haiku-4-5 и вернёт ошибку. ProxyAPI рекомендует всегда писать идентификатор целиком, вместе с вендором — такая запись работает на любом эндпоинте. Подробности — в статье про модели.

Два префикса перестают действовать. Они существовали только на адресе openai.api.proxyapi.ru и в едином API не нужны:

Что остаётся без изменений

Ключ прежний, перевыпускать его не нужно — тот же ключ работает и на прежних адресах, и на новом.

Структура запроса и ответа не меняется, как и стриминг, вызов функций, структурированный вывод и кэширование. Пакетная обработка, загрузка файлов и подсчёт токенов переезжают вместе с базовым адресом: /openai/v1/batches становится /v1/batches, /anthropic/v1/messages/count_tokens — /v1/messages/count_tokens.

Что появляется после перехода

Формат запроса перестаёт быть привязан к вендору модели. На /v1/chat/completions доступна любая текстовая модель каталога, включая модели Anthropic и Google: запрос переводится в формат конечного сервиса, а ответ — обратно. То же верно и для остальных форматов: Anthropic Messages, OpenAI Responses и Gemini принимают модели не только своего вендора.

Раньше для этого требовалось четыре разных адреса, а модель нельзя было сменить без правки кода. Что происходит с запросом при совпадении формата и модели и что меняется при переводе — в статье про нативные API.

Что дальше

• Прежние эндпоинты — полный список старых путей и их соответствие единому API.
• Единый API — адрес, структура запроса и ответа.
• Модели — идентификаторы и полный список каталога.