Naar inhoud springen
Developer Resources
Developer Resources

Cherry Studio

Verbind Cherry Studio met RunAPI en verifieer een chat.

Markdown bekijken

Verbind Cherry Studio met RunAPI via een aangepaste OpenAI-provider. Maak een standaard RunAPI API-sleutel aan in de Authenticatiehandleiding voordat u verdergaat.

Cherry Studio installeren

Installeer de desktopapplicatie door de officiële Cherry Studio-downloadhandleiding te volgen en open vervolgens de instellingen.

De RunAPI-provider toevoegen

  1. Open Settings -> Model Services -> + Add.
  2. Stel de providernaam in op RunAPI en Provider type op OpenAI.
  3. Voer uw RunAPI API-sleutel in en stel het API-adres in op https://runapi.ai/v1.
  4. Voeg een exacte modelidentificatie toe uit de Modelcatalogus, schakel de provider in en sla op.

Omdat het providertype OpenAI is, gebruikt dit veld de OpenAI-compatibele Basis-URL van RunAPI, inclusief /v1. Cherry Studio voegt /chat/completions toe voor een Chat Completions-verzoek; plak de volledige bewerkings-URL daarom niet in het veld voor het API-adres.

Een model selecteren

Aangepaste providers zijn afhankelijk van de modellen die u toevoegt. Als de selector leeg is, keer dan terug naar het modelbeheergebied van de provider en voeg handmatig een exacte RunAPI- identifier toe. Het toevoegen van een model verleent geen mogelijkheden die het model niet ondersteunt.

De verbindingscontrole uitvoeren

Voer Verbindingscontrole uit met het opgeslagen model. Dit stuurt een modelverzoek in plaats van alleen het sleutelformaat te valideren. Een geslaagde controle bevestigt dat de provider-URL, sleutel en het geselecteerde model samen werken.

De verbinding verifiëren

Start een nieuwe chat, selecteer de RunAPI-provider en het model, en stuur Reply with the word connected. Een normale volledige of gestreamde respons bevestigt dat de actieve chat RunAPI gebruikt.

Probleemoplossing

  • De modelselector is leeg: voeg de exacte modelidentificator toe in het modelbeheergebied van de aangepaste provider en controleer of de provider is ingeschakeld.
  • Verbindingscheck mislukt: controleer of een model is geselecteerd, vervang de sleutel door een geldige standaardsleutel en probeer het opnieuw.
  • Het verzoek geeft 404 terug: gebruik https://runapi.ai/v1 als het API-adres; voeg /chat/completions niet zelf toe.
  • Text werkt maar vision of tools niet: kies een model dat de vereiste mogelijkheid declareert in de Modelcatalogus.

Gebruik de LLM API-snelstart voor gedeeld protocolgedrag. Gebruik de Chat Completions API-referentie voor aanvraag- en antwoordvelden.