Przejdź do treści
Zasoby dla deweloperów
Zasoby dla deweloperów

Cherry Studio

Połącz Cherry Studio z RunAPI i zweryfikuj czat.

Połącz Cherry Studio z RunAPI za pomocą niestandardowego dostawcy OpenAI. Przed kontynuowaniem utwórz standardowy klucz API RunAPI w Przewodniku uwierzytelniania.

Instalacja Cherry Studio

Zainstaluj aplikację desktopową, postępując zgodnie z oficjalnym przewodnikiem pobierania Cherry Studio, a następnie otwórz jej ustawienia.

Dodaj dostawcę RunAPI

  1. Otwórz Settings -> Model Services -> + Add.
  2. Ustaw nazwę dostawcy na RunAPI, a Provider type na OpenAI.
  3. Wprowadź swój klucz API RunAPI i ustaw adres API na https://runapi.ai/v1.
  4. Dodaj dokładny identyfikator modelu z Katalogu modeli, włącz dostawcę i zapisz.

Ponieważ typ dostawcy to OpenAI, to pole używa bazowego URL zgodnego z OpenAI w RunAPI, który zawiera /v1. Cherry Studio dodaje /chat/completions dla żądania Chat Completions, dlatego nie wklejaj pełnego URL operacji w pole adresu API.

Wybierz model

Niestandardowi dostawcy korzystają z modeli, które dodasz. Jeśli selektor jest pusty, wróć do obszaru zarządzania modelami dostawcy i ręcznie dodaj dokładny identyfikator RunAPI. Dodanie modelu nie przyznaje możliwości, których dany model nie obsługuje.

Uruchom sprawdzenie połączenia

Uruchom Sprawdzenie połączenia z zapisanym modelem. Spowoduje to wysłanie żądania do modelu, a nie tylko weryfikację formatu klucza. Pomyślne sprawdzenie potwierdza, że adres URL dostawcy, klucz i wybrany model działają razem.

Weryfikuj połączenie

Rozpocznij nowy czat, wybierz dostawcę i model RunAPI, a następnie wyślij Reply with the word connected. Normalna kompletna lub strumieniowa odpowiedź potwierdza, że aktywny czat korzysta z RunAPI.

Rozwiązywanie problemów

  • Selektor modelu jest pusty: dodaj dokładny identyfikator modelu w obszarze zarządzania modelami niestandardowego dostawcy i upewnij się, że dostawca jest włączony.
  • Sprawdzenie połączenia kończy się niepowodzeniem: upewnij się, że model jest wybrany, zastąp klucz prawidłowym kluczem standardowym i spróbuj ponownie.
  • Żądanie zwraca 404: użyj https://runapi.ai/v1 jako adresu API; nie dołączaj samodzielnie /chat/completions.
  • Tekst działa, ale wizja lub narzędzia nie: wybierz model, który deklaruje wymaganą możliwość w Katalogu modeli.

W przypadku wspólnego zachowania protokołu skorzystaj z Szybkiego startu LLM API . W przypadku pól żądania i odpowiedzi skorzystaj z Dokumentacji interfejsu Chat Completions API.