Jak podłączyć własny model AI: adres API, klucz i tryb awaryjny
Skonfiguruj w Mono model zgodny z API OpenAI. Sprawdź połączenie, zachowanie po błędzie i różnicę między rozmową a obsługą narzędzi.
Podłączenie własnego modelu pozwala aplikacji wysyłać żądania do wybranego serwera. Model może działać na Twoim komputerze albo u zewnętrznego dostawcy. Wpisanie własnego adresu API nie oznacza, że model zaczyna działać na telefonie. Zanim przejdziesz do dokumentów lub automatyzacji, wyślij krótkie zapytanie bez poufnych danych.
Mono by Reunified pozwala używać własnego modelu, a odpowiedzi z modelu, który uruchamiasz sam, nic nie kosztują w Mono. Mono jest obecnie dostępne przez listę oczekujących. Ten poradnik pokazuje ustawienia i daje listę kontrolną na czas, gdy dostaniesz dostęp. Nawet jeśli serwer deklaruje zgodność, przetestuj go z dokładnie tą aplikacją i tym modelem, których używasz.
1. Zbierz właściwe dane połączenia
Potrzebujesz bazowego adresu URL API, dokładnego identyfikatora modelu i, jeśli jest wymagany, klucza API. Postępuj według instrukcji tego, kto obsługuje serwer. Adres strony internetowej, strona pobierania modelu czy adres serwera MCP to nie jest endpoint API modelu.
Mono wysyła zapytania tekstowe na ścieżkę Chat Completions pod wpisanym adresem, więc wpisz bazę API, a nie pełną ścieżkę. Na przykład jeśli dostawca podaje https://models.example.com/v1/chat/completions, wpisz https://models.example.com/v1. To wymyślony adres, a nie działająca usługa.
Sprawdź, co jeszcze obsługuje model. To, że odpowiada tekstem, nie znaczy, że obsługuje obrazy, narzędzia, strumieniowanie czy każdą opcję zapytania.
2. Skonfiguruj model dla jednej roli
Otwórz Ustawienia, potem Integracje, i włącz Model tekstowy w sekcji Własne endpointy. Wpisz adres URL endpointu, klucz API i ID modelu w odpowiednie pola. Nie umieszczaj kluczy w wiadomościach czatu ani na zrzutach ekranu. Lokalny serwer bez logowania może nie wymagać klucza, ale to nie czyni go bezpiecznym do wystawienia w internecie.
Zacznij od modelu tekstowego. Mono ma osobne ustawienia dla modeli tekstowego, do kodu i pomocniczego, więc zmiana jednego nie zmienia pozostałych. Zapisz, który zmieniłeś, żeby wiedzieć, od czego zacząć, gdy coś później przestanie działać.
Z własnym modelem tekstowym niektóre funkcje, takie jak narzędzia i umiejętności, mogą działać inaczej niż z wbudowanymi modelami Mono. Najpierw przetestuj zwykłą rozmowę. Jeśli proces potrzebuje umiejętności, dobra odpowiedź tekstowa nie dowodzi, że proces zadziała.
3. Ustal zachowanie po błędzie
Każdy własny model ma przełącznik „Użyj domyślnego modelu, gdy endpoint jest niedostępny”, domyślnie włączony. Nie zakładaj, że każda funkcja reaguje tak samo na niedziałający serwer. Przetestuj to: zatrzymaj serwer i zobacz, co dzieje się w funkcji, której używasz.
Jeśli Twoje zapytania mają trafiać wyłącznie do Twojego serwera, ze względu na prywatność lub koszty, wyłącz ten przełącznik i sprawdź, co się dzieje, gdy serwer zawiedzie. Sprawdź, dokąd naprawdę trafiają zapytania; samo ustawienie na ekranie to za mało. Zmiana modelu tekstowego zostawia też do sprawdzenia pozostałe modele i połączone narzędzia.
Przed przesłaniem poufnych materiałów lub porównaniem rachunków przeczytaj poradnik o prywatności AI oraz poradnik o kosztach korzystania z AI.
4. Wykonaj mały test połączenia
Poproś: „Zwróć trzy słowa: czerwony, zielony, niebieski, każde w osobnej linii”. Sprawdź, czy odpowiedź dociera, czy logi serwera (jeśli są) pokazują wybrany model i czy strona zużycia u dostawcy zgadza się z testem.
Potem przetestuj jedną funkcję, której naprawdę potrzebujesz, na przykład dłuższą rozmowę. Zmieniaj jedną rzecz naraz. Zapisz wersję aplikacji, wersję serwera, ID modelu i datę; wynik dla jednego zestawu nie znaczy, że zadziała każdy model.
Jeśli serwer działa na Twoim komputerze, przetestuj go też z prawdziwej sieci telefonu. Na telefonie localhost to sam telefon. Zamiast wystawiać niezabezpieczoną usługę do internetu, użyj obsługiwanej przez serwer metody połączenia z logowaniem.
5. Znajdź pierwszy etap, który zawodzi
| Objaw | Co sprawdzić najpierw |
|---|---|
| Upływa limit czasu połączenia | Czy serwer działa, czy urządzenie go widzi, reguły sieci |
| Odpowiedź o braku autoryzacji | Właściwy klucz, konto i wymagania logowania |
| Błąd „nie znaleziono” | Adres bazowy i czy ścieżka /chat/completions nie jest dopisana dwa razy |
| Nieznany model | Dokładne ID modelu dostępnego na tym serwerze |
| Rozmowa działa, ale proces nie | Narzędzia lub inne funkcje, których potrzebuje proces |
Usuń sekrety z każdego logu, który udostępniasz. Zalogowanie się na stronie dostawcy nie dowodzi, że klucz API działa, a udany test tekstowy nie znaczy, że model do kodu jest skonfigurowany.
6. Zachowaj możliwość cofnięcia zmiany
Zapisz poprzednie ustawienia, bez sekretów. Po zmianie serwera powtórz mały test i sprawdź koszty w aplikacji i u dostawcy. Zanim nazwiesz konfigurację „lokalną” albo „prywatną”, sprawdź też ustawienia pozostałych modeli.
Dołącz do listy oczekujących na Mono, aby otrzymywać informacje o dostępności. Jeśli chcesz podłączyć zewnętrzną usługę, a nie zastąpić model, skorzystaj z osobnego poradnika łączenia narzędzi MCP.
