К содержимому
Блог

Почему Base URL отличается для OpenAI и Anthropic

Почему Base URL отличается для OpenAI и Anthropic

Для OpenAI-совместимого клиента Relay задайте https://relay-llm.ru/v1. Для клиента Anthropic Messages задайте https://relay-llm.ru. Разница связана с тем, какую часть пути клиент добавляет к базовому адресу.

Базовый адрес и адрес запроса

Base URL задаёт начало адреса для SDK. Endpoint обозначает конкретную операцию. Если вы отправляете запрос через cURL, указывайте полный endpoint. Если настраиваете SDK, оставляйте маршрут операции библиотеке.

Клиент или операцияАдресЧто вводить
OpenAI-совместимый SDKhttps://relay-llm.ru/v1Base URL
Anthropic SDKhttps://relay-llm.ruBase URL
Chat Completions через cURLhttps://relay-llm.ru/v1/chat/completionsПолный URL
Messages через cURLhttps://relay-llm.ru/v1/messagesПолный URL

Не вставляйте адрес /chat/completions в поле Base URL редактора. Клиент может дописать маршрут ещё раз. Аналогичная ошибка в Anthropic-клиенте возникает при добавлении лишнего /v1.

Определите протокол клиента

Название модели не определяет формат запроса. Идентификатор возьмите из каталога, а поддержку протокола проверьте в ответе GET https://relay-llm.ru/api/public/models: у записи с нужным public_id поле protocols должно содержать openai_chat для Chat Completions или anthropic_messages для Messages. Если поле отсутствует, не делайте вывод о совместимости по названию модели. Клиент OpenAI использует свой базовый адрес даже при вызове модели Claude.

Claude Code и настройка Gateway в Claude Desktop описаны в интеграциях Relay. Для них проверьте поддержку Anthropic Messages у выбранной модели. Смена URL не преобразует тело запроса из одного протокола в другой.

Проверьте путь при ошибке

Сначала посмотрите итоговый URL в диагностике клиента. В нём не должно быть повторов /v1/v1, /messages/messages или /chat/completions/chat/completions. Уберите только лишнюю часть и повторите короткий запрос.

Затем проверьте HTTP-метод. Получение списка моделей и генерация ответа используют разные операции, поэтому проверка адреса в строке браузера не заменяет POST с JSON-телом.

Если путь верный, прочитайте код ошибки по документации. Ответ 404 может относиться к маршруту или к идентификатору модели. Для разбора нужны оба значения, а ключ в диагностический отчёт включать нельзя.

Закрепите адрес в приложении

Храните Base URL рядом с конфигурацией клиента, отдельно от секрета. При миграции меняйте адрес и ключ согласованно: старый ключ на новом адресе не подтверждает совместимость SDK. Матрица протоколов и различий находится в руководстве по протоколам.

Готовы подключиться?Войдите в консоль, пополните баланс и создайте API-ключ.