Свой 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. Сторонний сервис видит всё, что вы через него отправляете, поэтому заведите для него отдельный ключ с лимитом трат и никогда не отдавайте ему ключ от официального провайдера.

Что такое 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 отправляет первой выбранной модели один крошечный запрос. Если проверка прошла, подключение сохраняется; если нет, вы остаётесь на том же шаге и можете всё исправить.

Хотите всё задать сами? Есть ручная настройка
В режиме «Ручная настройка» всё собрано на одной странице: адрес, ключ, 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.», сравните свой адрес с документацией сервиса.
| Вы вводите | Oriveo запрашивает (формат OpenAI) |
|---|---|
| https://api.example.com | https://api.example.com/v1 |
| https://api.example.com/v1 | https://api.example.com/v1 |
| https://api.example.com/v1/chat/completions | https://api.example.com/v1, по протоколу Chat Completions |
| https://api.example.com/api/paas/v4 | https://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-совместимым. Обоих лучше добавлять как встроенных провайдеров.
| Провайдер | OpenAI-совместимый Base URL |
|---|---|
| OpenAI | https://api.openai.com/v1 |
| Google Gemini | https://generativelanguage.googleapis.com/v1beta/openai/ |
| OpenRouter | https://openrouter.ai/api/v1 |
| DeepSeek | https://api.deepseek.com |
| xAI (Grok) | https://api.x.ai/v1 |
| Groq | https://api.groq.com/openai/v1 |
| Together AI | https://api.together.ai/v1 |
| Fireworks AI | https://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 вводить?
Можно ли пользоваться своим эндпоинтом на iPhone и Android?
Почему Oriveo требует HTTPS?
Безопасно ли пользоваться API-ретранслятором или прокси?
Читайте также
Из блога
Подключите свой сервис моделей
Откройте веб-версию или скачайте Oriveo для iPhone или Android, выберите «Своя служба ретрансляции» и вставьте адрес и ключ своего сервиса.
Ещё нет API-ключа? Начните с Oriveo Free.