Cherry Studio
Conecte o Cherry Studio ao RunAPI e verifique uma conversa.
Conecte o Cherry Studio ao RunAPI com um provedor OpenAI personalizado. Crie uma Chave de API padrão do RunAPI no Guia de Autenticação antes de continuar.
Instalar Cherry Studio
Instale o aplicativo desktop seguindo o guia oficial de download do Cherry Studio e abra suas configurações.
Adicionar o provedor RunAPI
- Abra Settings -> Model Services -> + Add.
- Defina o nome do provedor como
RunAPIe Provider type como OpenAI. - Insira sua Chave de API do RunAPI e defina o endereço da API como
https://runapi.ai/v1. - Adicione um identificador de modelo exato do Catálogo de Modelos, habilite o provedor e salve.
Como o tipo de provedor é OpenAI, este campo utiliza a URL base compatível com OpenAI do RunAPI,
que inclui /v1. O Cherry Studio acrescenta
/chat/completions para uma requisição de Chat Completions, portanto não cole
a URL completa da operação no campo de endereço da API.
Selecionar um modelo
Provedores personalizados dependem dos modelos que você adiciona. Se o seletor estiver vazio, volte à área de gerenciamento de modelos do provedor e adicione um identificador RunAPI exato manualmente. Adicionar um modelo não concede capacidades que o modelo não suporta.
Executar a verificação de conexão
Execute Verificação de conexão com o modelo salvo. Isso envia uma requisição ao modelo em vez de apenas validar o formato da chave. Uma verificação bem-sucedida confirma que a URL do provedor, a chave e o modelo selecionado funcionam em conjunto.
Verificar a conexão
Inicie um novo chat, selecione o provedor e o modelo RunAPI, depois envie Reply
with the word connected. Uma resposta normal completa ou em streaming confirma
que o chat ativo está usando o RunAPI.
Solucionar problemas
- O seletor de modelos está vazio: adicione o identificador de modelo exato na área de gerenciamento de modelos do provider personalizado e confirme que o provider está habilitado.
- A verificação de conexão falha: confirme que um modelo está selecionado, substitua a chave por uma chave padrão válida e tente novamente.
- A requisição retorna
404: usehttps://runapi.ai/v1como endereço da API; não acrescente/chat/completionsmanualmente. - Text funciona, mas visão ou ferramentas falham: escolha um modelo que declare a capacidade necessária no Catálogo de Modelos.
Para comportamento de protocolo compartilhado, use o Início rápido da API LLM. Para campos de requisição e resposta, use a Referência da API Chat Completions.