Własny punkt końcowy i Base URL

Własny punkt końcowy API: jak podłączyć API zgodne z OpenAI

Czym jest własny punkt końcowy API i Base URL oraz jak podłączyć API zgodne z OpenAI, usługę pośredniczącą, proxy lub bramkę — wystarczą adres i klucz.

Zaktualizowano
  • Własny punkt końcowy API (custom API endpoint) to adres internetowy, czyli Base URL, usługi AI, która nie jest wbudowana w twoją aplikację — np. API zgodnego z OpenAI, usługi pośredniczącej (relay), proxy lub bramki (gateway). Aby go podłączyć w Oriveo, zwykle potrzebujesz dwóch rzeczy: tego adresu i klucza API.
  • Oriveo samo ustala protokół (OpenAI Chat Completions, OpenAI Responses, Anthropic Messages lub Gemini) i dopisuje ścieżkę wersji, np. /v1, gdy podasz sam adres główny.
  • Adresy publiczne muszą używać HTTPS. Zewnętrzna usługa widzi wszystko, co przez nią wysyłasz, więc daj jej osobny klucz z limitem wydatków i nigdy nie przekazuj jej klucza z oficjalnego konta u dostawcy.
Oriveo na iPhonie: ekran dostawców z listą podłączonych dostawców i wydatkami z tego miesiąca.

Czym jest Base URL lub punkt końcowy API?

Każda usługa AI ma adres internetowy, na który aplikacje wysyłają żądania. Programiści nazywają go Base URL (adres bazowy), punktem końcowym API (API endpoint) albo adresem URL żądania; tutaj wszystkie te nazwy znaczą to samo. Wygląda jak zwykły adres strony, np. adres OpenAI to https://api.openai.com/v1.

W Oriveo 15 wbudowanych dostawców ma adresy już wpisane, więc wystarczy wkleić klucz. Własny punkt końcowy służy do całej reszty: usługi oferującej API zgodne z OpenAI, usługi pośredniczącej lub bramki prowadzonej przez firmę albo bramki uruchomionej na twoim własnym serwerze.

„Zgodne z OpenAI” (OpenAI-compatible) oznacza, że usługa przyjmuje żądania w tym samym formacie co API OpenAI, więc aplikacje napisane z myślą o OpenAI mogą się z nią porozumieć. Taki format oferuje wielu dostawców i wiele bramek.

Usługa pośrednicząca (relay), proxy, bramka (gateway): czym się różnią?

Te nazwy bywają używane zamiennie, a z punktu widzenia aplikacji wszystkie te rozwiązania działają tak samo: między twoją aplikacją a dostawcami modeli stoi usługa, która odbiera żądanie i przekazuje je dalej. Niektóre zbierają kilku dostawców pod jednym kluczem i jednym rachunkiem, inne dodają kontrolę zużycia dla zespołu, a jeszcze inne to oprogramowanie, które uruchamiasz na własnym serwerze.

Oriveo nie poleca żadnej z nich ani nie tworzy ich rankingu. Niezależnie od tego, z której korzystasz, kroki poniżej są takie same.

Czego potrzebuję, żeby podłączyć własny punkt końcowy?

Zwykle dwóch rzeczy — obie znajdziesz w panelu lub dokumentacji danej usługi:

  • Adres URL żądania (Base URL), np. https://api.example.com/v1. Jeśli usługa działa w publicznym internecie, adres musi zaczynać się od https://.
  • Klucz API wydany ci przez tę usługę. Kolejne klucze dodasz przyciskiem „Dodaj kolejny klucz”.
  • Opcjonalnie: nazwa połączenia, żeby odróżnić je od innych.

Jak dodać własny punkt końcowy w Oriveo?

Kroki są takie same na iPhonie, Androidzie i w wersji webowej.

  • Otwórz „Dostawcy” i stuknij przycisk + („Dodaj dostawcę”).
  • Wybierz filtr „Własny”, a potem „Własna usługa pośrednicząca” („Podłącz własną usługę modeli”).
  • Na ekranie „Połącz własną usługę pośredniczącą” wklej adres URL żądania i klucz API. Wiersz „Zażąda: …” pokazuje pełny adres, którego użyje Oriveo. Stuknij „Dalej”.
  • Oriveo sprawdza połączenie, odczytuje listę modeli i ustala protokół każdego z nich. Ten krok tylko czyta listę i nie wysyła żadnej wiadomości czatu.
  • Zaznacz modele, które chcesz, i stuknij „Zapisz (wybrano: N)”. Jeśli usługa nie udostępnia listy modeli, użyj opcji „Dodaj ID modelu ręcznie”.
  • Przed zapisaniem Oriveo wysyła jedno małe żądanie do pierwszego zaznaczonego modelu. Połączenie zostaje zapisane, gdy ten test przejdzie; jeśli się nie powiedzie, zostajesz na tym samym kroku i możesz to poprawić.
Ekran „Dostawcy” w Oriveo na iPhonie z przyciskiem + w prawym górnym rogu i listą podłączonych dostawców
Stuknij + na ekranie „Dostawcy” i wybierz „Własny”, aby dodać punkt końcowy obok wbudowanych dostawców.

Wolisz ustawić wszystko samodzielnie? Użyj konfiguracji ręcznej

„Konfiguracja ręczna” zbiera wszystko na jednej stronie: adres, klucz, ID modelu, opcjonalną nazwę połączenia i domyślny protokół, początkowo ustawiony na wybór automatyczny. Stuknij „Zweryfikuj i zapisz”. Jeśli sprawdzanie się nie powiedzie, nic nie zostaje jeszcze zapisane, a na karcie błędu pojawia się przycisk „Zapisz mimo to (niezweryfikowano)” — przyda się, jeśli chcesz zachować połączenie i przetestować je później.

Czy Oriveo samo wykrywa protokół?

W większości przypadków tak. Usługi AI posługują się jednym z kilku formatów żądań, zwanych protokołami. Oriveo obsługuje cztery: OpenAI Chat Completions, OpenAI Responses, Anthropic Messages i Gemini generateContent.

Decyzję podejmuje osobno dla każdego modelu. Korzysta z informacji, które usługa podaje o danym modelu, jeśli takie istnieją, a w przeciwnym razie wybiera prawdopodobne opcje na podstawie rodziny modelu. Przy zapisywaniu pierwszy zaznaczony model jest testowany prawdziwym żądaniem; pozostałe są sprawdzane później, gdy zaczniesz z nich korzystać.

Dlatego w większości przypadków wystarczą adres i klucz. Jeśli dokumentacja usługi wskazuje konkretny protokół albo któryś model nie przejdzie sprawdzenia, wybierz protokół samodzielnie na ekranie „Konfiguracja ręczna”.

Czy muszę dopisać /v1 do adresu?

Zwykle nie. Jeśli wpiszesz sam adres główny, np. https://api.example.com, Oriveo dopisze standardową ścieżkę wersji dla danego protokołu: /v1 dla formatów OpenAI i Anthropic, /v1beta dla Gemini.

Jeśli adres zawiera już wersję, np. /api/paas/v4, Oriveo ją zachowa. Jeśli wkleisz pełny punkt końcowy kończący się na /chat/completions, /responses, /messages lub :generateContent, Oriveo usunie tę końcówkę i na jej podstawie rozpozna, jakim protokołem posługuje się usługa.

Zanim stukniesz „Dalej”, sprawdź wiersz „Zażąda: …”. Jeśli sprawdzanie zwróci komunikat „Adres może wskazywać stronę internetową. Sprawdź, czy nie brakuje /v1.”, porównaj swój adres z dokumentacją usługi.

Czy muszę dopisać /v1 do adresu?
WpisujeszOriveo wysyła żądania na (format 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, z protokołem Chat Completions
https://api.example.com/api/paas/v4https://api.example.com/api/paas/v4

Jakie adresy są dozwolone?

Oriveo trzyma się kilku zasad, które chronią twój klucz:

  • Adresy publiczne muszą zaczynać się od https://. Adresu http:// w publicznym internecie nie da się przetestować ani zapisać.
  • Adresy z nazwą użytkownika i hasłem w środku albo z parametrami zapytania (wszystko po znaku „?”) nie są akceptowane. Oriveo nigdy nie używa kluczy API z parametrów zapytania.
  • Zwykłe adresy http:// w sieci domowej lub prywatnym VPN, np. serwer modeli na twoim komputerze, dodaje się przez osobną pozycję do mocy lokalnej („Moc lokalna” na Androidzie, „Moc obliczeniowa lokalna i w sieci lokalnej” na iPhonie), a nie przez pozycję „Własna usługa pośrednicząca”.
  • Na iPhonie i Androidzie aplikacja łączy się z adresem bezpośrednio.
  • W wersji webowej publiczne adresy URL żądań są przekazywane przez serwer Oriveo, aby obejść ograniczenia CORS przeglądarki (zasadę bezpieczeństwa przeglądarek, która blokuje wiele bezpośrednich żądań). Twój klucz API jest przechowywany w pamięci tylko na czas tego żądania i nigdy nie jest zapisywany ani rejestrowany. Adresy w sieci lokalnej łączą się bezpośrednio z twojego urządzenia, a HTTPS jest wymagany w obu przypadkach; do zwykłego adresu http:// w sieci domowej potrzebujesz aplikacji na iPhone’a lub Androida i jej pozycji do mocy lokalnej.
  • Klucze zostają na tym urządzeniu i nie są przesyłane przez synchronizację w chmurze.

Base URL wbudowanych dostawców

W Oriveo nie są ci potrzebne: wystarczy wybrać dostawcę po nazwie. Podajemy je, bo ludzie często ich szukają do innych narzędzi. Każdy to oficjalny adres zgodny z OpenAI podany w dokumentacji dostawcy, według stanu na 18 listopada 2026 r.

  • Anthropic opisuje swoją warstwę zgodną z OpenAI jako przeznaczoną do testów i porównań, a przewodnik szybkiego startu Mistral nie opisuje jego API jako zgodnego z OpenAI. Oba dodaj jako wbudowanych dostawców.
Base URL wbudowanych dostawców
DostawcaBase URL zgodny z 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 (międzynarodowy)https://api.minimax.io/v1
Z.ai (międzynarodowy)https://api.z.ai/api/paas/v4/
Qwen (region Singapur)https://dashscope-intl.aliyuncs.com/compatible-mode/v1
Kimi (międzynarodowy)https://api.moonshot.ai/v1
SiliconFlow (międzynarodowy)https://api.siliconflow.com/v1

Czy korzystanie z usługi pośredniczącej lub zewnętrznego API jest bezpieczne?

Zachowaj ostrożność. Każda usługa stojąca między tobą a modelem może czytać twoje prompty, załączane pliki i odpowiedzi, a do tego ustala własne ceny. Oriveo nie widzi, co dzieje się w jej środku, i nie może za nią ręczyć.

  • Nigdy nie przekazuj zewnętrznej usłudze klucza API z oficjalnego konta u dostawcy. Używaj klucza, który wydała ci ta usługa.
  • Utwórz osobny klucz dla Oriveo i ustaw na nim limit wydatków albo trzymaj na nim niewielkie saldo, jeśli usługa na to pozwala.
  • Nie wysyłaj haseł, numerów dokumentów ani poufnych materiałów służbowych przez usługę, której nie ufasz.
  • Sprawdzaj zużycie w panelu samej usługi. Koszty w Oriveo są szacunkowe; wiążące są dane samej usługi.
  • Jeśli klucz wycieknie, usuń go w panelu usługi i utwórz nowy.

Dlaczego mój własny punkt końcowy się nie łączy?

Oriveo w jednym zdaniu mówi, co poszło nie tak. Tak brzmią te komunikaty w polskiej wersji:

  • Co oznaczają kody takie jak 401, 402 i 429, wyjaśnia nasz poradnik o błędach kluczy API.
Dlaczego mój własny punkt końcowy się nie łączy?
Komunikat w OriveoCo sprawdzić
Adres może wskazywać stronę internetową. Sprawdź, czy nie brakuje /v1.Porównaj adres z dokumentacją usługi; dodaj lub usuń ścieżkę wersji
Klucz jest nieprawidłowy.Skopiuj klucz ponownie z panelu usługi
Ten klucz nie może wyświetlić listy modeli. Możesz dodać modele ręcznie.W następnym kroku dodaj ID modelu samodzielnie
Nie można się połączyć. Sprawdź sieć lub serwer proxy.Sprawdź połączenie z internetem i czy adres jest osiągalny
Usługa pod tym adresem ogranicza liczbę żądań.Odczekaj chwilę i spróbuj ponownie
To połączenie nie mogło połączyć się z dostawcą nadrzędnym.Konto, które usługa ma u dostawcy, może być nieważne, bez środków lub objęte limitem żądań; skontaktuj się z tym, kto ją prowadzi

Najczęstsze pytania

Czym jest własny punkt końcowy API (custom API endpoint)?
To adres internetowy usługi AI, która nie jest wbudowana w twoją aplikację, np. API zgodnego z OpenAI, usługi pośredniczącej lub bramki. Podłączasz go, wpisując ten adres (Base URL) i klucz API od tej usługi.
Co to jest API zgodne z OpenAI?
API, które przyjmuje żądania w tym samym formacie co API OpenAI, więc mogą z niego korzystać aplikacje napisane z myślą o OpenAI. Oferuje je wielu dostawców i wiele bramek, zwykle pod adresem kończącym się na /v1.
Jaki Base URL mam wpisać?
Ten z dokumentacji usługi. Jeśli podaje ona tylko domenę, wpisz ją, a Oriveo dopisze /v1 (lub /v1beta dla formatu Gemini). Zanim przejdziesz dalej, sprawdź wiersz „Zażąda: …”.
Czy własny punkt końcowy działa na iPhonie i Androidzie?
Tak. Pozycja „Własna usługa pośrednicząca” jest dostępna w aplikacjach Oriveo na iPhone’a i Androida oraz w wersji webowej. Na iPhonie i Androidzie aplikacja łączy się z adresem bezpośrednio.
Dlaczego Oriveo wymaga HTTPS?
HTTPS szyfruje połączenie, więc twój klucz i wiadomości nie wędrują przez internet jawnym tekstem. Do serwera modeli w sieci domowej użyj pozycji do mocy lokalnej („Moc lokalna” na Androidzie, „Moc obliczeniowa lokalna i w sieci lokalnej” na iPhonie).
Czy korzystanie z usługi pośredniczącej API lub proxy jest bezpieczne?
Taka usługa może czytać wszystko, co przez nią wysyłasz, więc liczy się zaufanie. Używaj klucza, który dała ci ta usługa, nigdy oficjalnego klucza od dostawcy, ustaw limit wydatków i nie wysyłaj przez nią poufnych informacji.

Powiązane lektury

Podłącz własną usługę modeli

Otwórz wersję webową albo pobierz Oriveo na iPhone’a lub Androida, wybierz „Własna usługa pośrednicząca” i wklej adres oraz klucz od swojej usługi.

Nie masz jeszcze klucza API? Zacznij od Oriveo Free.