Власні кінцеві точки та Base URL

Власна кінцева точка API: як підключити API, сумісний з OpenAI

Що таке власна кінцева точка API і Base URL та як підключити API, сумісний з OpenAI, посередницький сервіс, проксі чи шлюз, маючи лише адресу й ключ.

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

Що таке Base URL або кінцева точка API?

Кожен сервіс ШІ має вебадресу, на яку застосунки надсилають запити. Розробники називають її Base URL (базова адреса), API endpoint (кінцева точка API) або request URL (адреса запиту) — тут усі ці назви означають одне й те саме. Вона має вигляд звичайної вебадреси; в OpenAI, наприклад, це https://api.openai.com/v1.

В Oriveo адреси 15 вбудованих постачальників уже заповнено, тож достатньо вставити ключ. Власна кінцева точка — для всього іншого: сервісу з API, сумісним з OpenAI, посередницького сервісу чи шлюзу, яким керує компанія, або шлюзу, який ви запускаєте на власному сервері.

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

Посередницький сервіс, проксі, шлюз: у чому різниця?

Ці слова вживають досить вільно, а для підключення застосунку всі вони працюють однаково: сервіс стоїть між вашим застосунком і постачальниками моделей, приймає ваш запит і передає його далі. Одні об’єднують кількох постачальників під одним ключем і одним рахунком, другі додають контроль використання для команди, треті — це програмне забезпечення, яке ви запускаєте на власному сервері.

Oriveo не рекомендує жодного з них і не складає їхніх рейтингів. Хоч би яким ви користувалися, кроки нижче однакові.

Що потрібно, щоб підключити власну кінцеву точку?

Зазвичай дві речі — обидві є в панелі керування або документації самого сервісу:

  • Адреса запиту (Base URL), наприклад https://api.example.com/v1. Якщо сервіс працює в публічному інтернеті, адреса має починатися з https://.
  • Ключ API, який вам видав цей сервіс. Додаткові ключі можна додати кнопкою «Додати ще один ключ».
  • За бажанням: назва з’єднання, щоб відрізняти його від інших.

Як додати власну кінцеву точку в Oriveo?

Кроки однакові на iPhone, Android і у вебі.

  • Відкрийте «Постачальники» й натисніть кнопку + («Додати постачальника»).
  • Виберіть фільтр «Власний», а потім «Власний посередницький сервіс» (з підписом «Підключіть власний сервіс моделей»).
  • На екрані «Підключити власний посередницький сервіс» вставте адресу запиту та ключ API. Рядок «Запросить …» показує повну адресу, яку використовуватиме Oriveo. Натисніть «Далі».
  • Oriveo перевіряє з’єднання, зчитує список моделей і визначає протокол кожної моделі. На цьому кроці список лише зчитується, повідомлення в чат не надсилаються.
  • Позначте потрібні моделі й натисніть «Зберегти (вибрано: N)». Якщо сервіс не надає списку моделей, скористайтеся кнопкою «Додати ID моделі вручну».
  • Перед збереженням 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 — «Локальні обчислення та обчислення в локальній мережі»), а не через «Власний посередницький сервіс».
  • На iPhone та Android застосунок підключається до адреси напряму.
  • У вебверсії публічні URL запитів пересилаються через сервер Oriveo, щоб обійти обмеження CORS браузера (правило безпеки браузера, яке блокує багато прямих запитів). Ваш ключ API зберігається в пам’яті лише на час цього запиту й ніколи не записується та не журналюється. Адреси локальної мережі підключаються безпосередньо з вашого пристрою, і в обох випадках потрібен HTTPS; для звичайної адреси http:// у домашній мережі потрібен застосунок для iPhone чи Android і згаданий вище пункт локальних обчислень.
  • Ключі залишаються на цьому пристрої й не вивантажуються хмарною синхронізацією.

Base URL вбудованих постачальників

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

  • Anthropic описує свій шар сумісності з OpenAI як призначений для тестування й порівняння, а в короткому посібнику (quickstart) Mistral API цього постачальника не описано як сумісний з OpenAI. Тож додавайте обох як вбудованих постачальників.
Base URL вбудованих постачальників
ПостачальникBase URL, сумісний з OpenAI
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)?
Це вебадреса сервісу ШІ, якого немає серед вбудованих у вашому застосунку, — наприклад, API, сумісного з OpenAI, посередницького сервісу чи шлюзу. Щоб його підключити, введіть цю адресу (Base URL) та ключ API від сервісу.
Що таке API, сумісний з OpenAI?
Це API, який приймає запити в тому самому форматі, що й API OpenAI, тож ним можуть користуватися застосунки, створені для OpenAI. Такий API пропонує багато постачальників і шлюзів, зазвичай за адресою, що закінчується на /v1.
Який Base URL вводити?
Той, що вказано в документації сервісу. Якщо там є лише домен, введіть його, і Oriveo додасть /v1 (або /v1beta для формату Gemini). Перш ніж продовжити, перевірте рядок «Запросить …».
Чи можна користуватися власною кінцевою точкою на iPhone та Android?
Так. «Власний посередницький сервіс» є в застосунках Oriveo для iPhone та Android і у вебверсії. На iPhone та Android застосунок підключається до адреси напряму.
Чому Oriveo вимагає HTTPS?
HTTPS шифрує з’єднання, тож ваш ключ і повідомлення не передаються інтернетом відкритим текстом. Для сервера моделей у домашній мережі скористайтеся пунктом «Локальні обчислення» (на iPhone — «Локальні обчислення та обчислення в локальній мережі»).
Чи безпечно користуватися посередницьким сервісом або проксі для API?
Такий сервіс може читати все, що ви через нього надсилаєте, тож усе залежить від довіри. Користуйтеся ключем, який видав вам сервіс, а не ключем офіційного постачальника, встановіть ліміт витрат і не передавайте через нього конфіденційну інформацію.

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

Підключіть власний сервіс моделей

Відкрийте вебверсію або завантажте Oriveo для iPhone чи Android, виберіть «Власний посередницький сервіс» і вставте адресу та ключ свого сервісу.

Ще немає ключа API? Почніть з Oriveo Free — ключ не потрібен.