Custom API endpoint и Base URL

Свой API-эндпоинт: как подключить OpenAI-совместимый API

Что такое свой API-эндпоинт и Base URL и как подключить OpenAI-совместимый API, ретранслятор (relay), прокси или шлюз: нужны только адрес и ключ.

Обновлено
  • Свой API-эндпоинт (custom API endpoint) — это веб-адрес, или Base URL, ИИ-сервиса, который не встроен в ваше приложение: OpenAI-совместимого API, ретранслятора (relay), прокси или шлюза (gateway). Чтобы подключить такой сервис в Oriveo, обычно нужны две вещи: этот адрес и API-ключ.
  • Протокол Oriveo определяет сам (OpenAI Chat Completions, OpenAI Responses, Anthropic Messages или Gemini) и дописывает путь версии, например /v1, если вы ввели только корневой адрес.
  • Публичные адреса должны работать по HTTPS. Сторонний сервис видит всё, что вы через него отправляете, поэтому заведите для него отдельный ключ с лимитом трат и никогда не отдавайте ему ключ от официального провайдера.
Oriveo на iPhone: экран провайдеров со списком подключённых вами провайдеров и расходами за месяц.

Что такое Base URL или API-эндпоинт

У каждого ИИ-сервиса есть веб-адрес, на который приложения отправляют запросы. Разработчики называют его Base URL, API endpoint (эндпоинт) или URL запроса — здесь всё это одно и то же. Выглядит он как обычный веб-адрес; у OpenAI, например, это https://api.openai.com/v1.

У 15 встроенных в Oriveo провайдеров адреса уже указаны, так что достаточно вставить ключ. Свой эндпоинт нужен для всего остального: сервиса с OpenAI-совместимым API, ретранслятора или шлюза, который держит какая-то компания, или шлюза на вашем собственном сервере.

«OpenAI-совместимый» значит, что сервис принимает запросы в том же формате, что и API OpenAI, поэтому приложения, сделанные для OpenAI, могут с ним работать. Такой формат предлагают многие провайдеры и шлюзы.

Ретранслятор, прокси, шлюз: в чём разница

Эти слова употребляют вольно, и для подключения приложения разницы между ними нет: сервис стоит между вашим приложением и провайдерами моделей, принимает запрос и передаёт его дальше. Одни собирают нескольких провайдеров под одним ключом и одним счётом, другие добавляют контроль расходов для команды, третьи — это программы, которые запускают на собственном сервере.

Oriveo никого из них не рекомендует и не ранжирует. Каким бы сервисом вы ни пользовались, шаги ниже одинаковые.

Что нужно, чтобы подключить свой эндпоинт

Обычно две вещи, обе — из личного кабинета или документации сервиса:

  • URL запроса (Base URL), например https://api.example.com/v1. Если сервис работает в публичном интернете, адрес должен начинаться с https://.
  • API-ключ, который выдал вам этот сервис. Дополнительные ключи можно добавить кнопкой «Добавить ещё ключ».
  • По желанию — название подключения, чтобы отличать его от других.

Как добавить свой эндпоинт в Oriveo

Шаги одинаковые на iPhone, Android и в вебе.

  • Откройте «Провайдеры» и нажмите кнопку + («Добавить провайдера»).
  • Выберите фильтр «Пользовательский», затем «Своя служба ретрансляции» («Подключите свой сервис моделей»).
  • На экране «Подключить свою службу ретрансляции» вставьте URL запроса и API-ключ. Строка «Адрес запроса: …» показывает полный адрес, который будет использовать Oriveo. Нажмите «Далее».
  • Oriveo проверит подключение, прочитает список моделей и определит протокол каждой из них. На этом шаге список только читается, сообщения в чат не отправляются.
  • Отметьте нужные модели и нажмите «Сохранить (выбрано: N)». Если сервис не отдаёт список моделей, воспользуйтесь кнопкой «Добавить идентификатор модели вручную».
  • Перед сохранением Oriveo отправляет первой выбранной модели один крошечный запрос. Если проверка прошла, подключение сохраняется; если нет, вы остаётесь на том же шаге и можете всё исправить.
Экран «Провайдеры» в Oriveo на iPhone с кнопкой + в правом верхнем углу и списком подключённых провайдеров
Нажмите + на экране «Провайдеры» и выберите «Пользовательский», чтобы добавить эндпоинт рядом со встроенными провайдерами.

Хотите всё задать сами? Есть ручная настройка

В режиме «Ручная настройка» всё собрано на одной странице: адрес, ключ, ID модели, необязательное название подключения и протокол по умолчанию — изначально он определяется автоматически. Нажмите «Проверить и сохранить». Если проверка не пройдёт, ничего не сохранится, а на карточке ошибки появится кнопка «Всё равно сохранить (не проверено)» — на случай, если вы хотите оставить подключение и проверить его позже.

Определяет ли Oriveo протокол автоматически?

Как правило, да. ИИ-сервисы общаются в одном из нескольких форматов запросов — их называют протоколами. Oriveo поддерживает четыре: OpenAI Chat Completions, OpenAI Responses, Anthropic Messages и Gemini generateContent.

Решение принимается для каждой модели отдельно. Если сервис сообщает сведения о модели, Oriveo опирается на них, а если нет — подбирает вероятные варианты по семейству модели. При сохранении первая выбранная модель проверяется настоящим запросом, остальные — позже, когда вы начнёте ими пользоваться.

Так что в большинстве случаев хватает адреса и ключа. Если в документации сервиса указан конкретный протокол или модель не прошла проверку, выберите протокол сами в ручной настройке.

Нужно ли дописывать /v1 к адресу?

Обычно нет. Если ввести только корневой адрес, например https://api.example.com, Oriveo сам добавит стандартный путь версии для протокола: /v1 для форматов OpenAI и Anthropic, /v1beta для Gemini.

Если в адресе уже есть версия, например /api/paas/v4, Oriveo её сохранит. Если вставить полный адрес, который заканчивается на /chat/completions, /responses, /messages или :generateContent, Oriveo отрежет это окончание и по нему поймёт, на каком протоколе работает сервис.

Прежде чем нажать «Далее», проверьте строку «Адрес запроса: …». Если проверка пишет «Возможно, адрес ведёт на веб-страницу. Проверьте, не пропущен ли /v1.», сравните свой адрес с документацией сервиса.

Нужно ли дописывать /v1 к адресу?
Вы вводитеOriveo запрашивает (формат OpenAI)
https://api.example.comhttps://api.example.com/v1
https://api.example.com/v1https://api.example.com/v1
https://api.example.com/v1/chat/completionshttps://api.example.com/v1, по протоколу Chat Completions
https://api.example.com/api/paas/v4https://api.example.com/api/paas/v4

Какие адреса допускаются

Чтобы защитить ваш ключ, Oriveo следует нескольким правилам:

  • Публичные адреса должны начинаться с https://. Адрес http:// в публичном интернете нельзя ни проверить, ни сохранить.
  • Адреса с логином и паролем внутри или с параметрами запроса (всё, что после «?») не принимаются. Oriveo никогда не пробует брать API-ключи из параметров запроса.
  • Обычные адреса http:// в домашней сети или частном VPN, например сервер моделей на вашем компьютере, подключаются не через пункт «Своя служба ретрансляции», а через отдельный пункт «Локальные вычисления» (на iPhone он называется «Локальные и LAN-вычисления»).
  • На iPhone и Android приложение подключается к адресу напрямую.
  • В веб-версии запросы к публичным URL проходят через сервер Oriveo, чтобы обойти ограничения CORS в браузере (это правило безопасности браузера, которое блокирует многие прямые запросы): ваш API-ключ находится в памяти только на время этого запроса и никогда не сохраняется и не попадает в логи. К адресам в локальной сети подключение идёт напрямую с вашего устройства, и в обоих случаях нужен HTTPS; для обычного адреса http:// в домашней сети нужны приложение для iPhone или Android и пункт «Локальные вычисления» (на iPhone — «Локальные и LAN-вычисления»).
  • Ключи хранятся только на этом устройстве и не выгружаются при облачной синхронизации.

Base URL встроенных провайдеров

В Oriveo эти адреса не нужны: просто выберите провайдера по названию. Мы приводим их, потому что их часто ищут для других программ. Каждый — официальный OpenAI-совместимый адрес из документации провайдера по состоянию на 18 ноября 2026 года.

  • Anthropic описывает свой OpenAI-совместимый слой как средство для тестирования и сравнения, а в кратком руководстве Mistral его API не назван OpenAI-совместимым. Обоих лучше добавлять как встроенных провайдеров.
Base URL встроенных провайдеров
ПровайдерOpenAI-совместимый Base URL
OpenAIhttps://api.openai.com/v1
Google Geminihttps://generativelanguage.googleapis.com/v1beta/openai/
OpenRouterhttps://openrouter.ai/api/v1
DeepSeekhttps://api.deepseek.com
xAI (Grok)https://api.x.ai/v1
Groqhttps://api.groq.com/openai/v1
Together AIhttps://api.together.ai/v1
Fireworks AIhttps://api.fireworks.ai/inference/v1
MiniMax (международная версия)https://api.minimax.io/v1
Z.ai (международная версия)https://api.z.ai/api/paas/v4/
Qwen (регион Сингапур)https://dashscope-intl.aliyuncs.com/compatible-mode/v1
Kimi (международная версия)https://api.moonshot.ai/v1
SiliconFlow (международная версия)https://api.siliconflow.com/v1

Безопасно ли пользоваться ретранслятором или сторонним API?

Будьте осторожны. Любой сервис между вами и моделью может читать ваши запросы, прикреплённые файлы и ответы, а цены он устанавливает сам. Oriveo не видит, что происходит внутри такого сервиса, и не может за него ручаться.

  • Никогда не отдавайте стороннему сервису API-ключ от своего аккаунта у официального провайдера. Используйте ключ, который выдал вам сам сервис.
  • Заведите для Oriveo отдельный ключ и, если сервис позволяет, задайте для него лимит трат или держите на нём небольшой баланс.
  • Не отправляйте пароли, номера документов и конфиденциальные рабочие данные через сервис, которому не доверяете.
  • Проверяйте расход в личном кабинете сервиса. Суммы в Oriveo — оценка, окончательные данные — в учёте самого сервиса.
  • Если ключ утёк, удалите его в кабинете сервиса и создайте новый.

Почему не подключается свой эндпоинт

Oriveo одной строкой сообщает, что пошло не так. Так сообщения выглядят в русской версии приложения:

  • Что значат коды вроде 401, 402 и 429, объясняет наше руководство по ошибкам API-ключей.
Почему не подключается свой эндпоинт
Сообщение в OriveoЧто проверить
Возможно, адрес ведёт на веб-страницу. Проверьте, не пропущен ли /v1.Сравните адрес с документацией сервиса; добавьте или уберите путь версии
Ключ недействителен.Скопируйте ключ из кабинета сервиса ещё раз
У этого ключа нет доступа к списку моделей. Модели можно добавить вручную.Добавьте ID модели сами на следующем шаге
Не удаётся подключиться. Проверьте сеть или прокси.Проверьте подключение к интернету и доступность адреса
Сервис по этому адресу ограничивает частоту запросов.Подождите немного и повторите
Этому подключению не удалось связаться с вышестоящим провайдером.Возможно, собственный аккаунт сервиса у провайдера недействителен, остался без средств или упёрся в лимит запросов; свяжитесь с тем, кто управляет сервисом

Частые вопросы о приложении

Что такое свой API-эндпоинт (custom API endpoint)?
Это веб-адрес ИИ-сервиса, который не встроен в ваше приложение: OpenAI-совместимого API, ретранслятора или шлюза. Подключают его, указав этот адрес (Base URL) и API-ключ от сервиса.
Что такое OpenAI-совместимый API?
API, который принимает запросы в том же формате, что и API OpenAI, поэтому им могут пользоваться приложения, сделанные для OpenAI. Такой API есть у многих провайдеров и шлюзов, обычно по адресу, который заканчивается на /v1.
Какой Base URL вводить?
Тот, что указан в документации сервиса. Если там дан только домен, введите его, и Oriveo добавит /v1 (или /v1beta для формата Gemini). Прежде чем продолжить, проверьте строку «Адрес запроса: …».
Можно ли пользоваться своим эндпоинтом на iPhone и Android?
Да. «Своя служба ретрансляции» есть в приложениях Oriveo для iPhone и Android и в веб-версии. На iPhone и Android приложение подключается к адресу напрямую.
Почему Oriveo требует HTTPS?
HTTPS шифрует соединение, и ваш ключ и сообщения не передаются по интернету открытым текстом. Для сервера моделей в домашней сети используйте пункт «Локальные вычисления» (на iPhone — «Локальные и LAN-вычисления»).
Безопасно ли пользоваться API-ретранслятором или прокси?
Такой сервис может читать всё, что через него проходит, поэтому важно доверие. Используйте ключ, который выдал сам сервис, а не ключ официального провайдера, задайте лимит трат и не передавайте через сервис чувствительные данные.

Читайте также

Из блога

Подключите свой сервис моделей

Откройте веб-версию или скачайте Oriveo для iPhone или Android, выберите «Своя служба ретрансляции» и вставьте адрес и ключ своего сервиса.

Ещё нет API-ключа? Начните с Oriveo Free.