---
title: Cherry Studio | RunAPI
description: Conecte o Cherry Studio ao RunAPI e verifique uma conversa.
url: https://runapi.ai/pt-BR/docs/resources/application-practices/cherry-studio.md
canonical: https://runapi.ai/pt-BR/docs/resources/application-practices/cherry-studio
locale: pt-BR
---

> Versão HTML: https://runapi.ai/pt-BR/docs/resources/application-practices/cherry-studio
> Índice do site para agentes: https://runapi.ai/llms.txt

# Cherry Studio

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](https://runapi.ai/pt-BR/docs/guides/authentication.md) antes de continuar.

## Instalar Cherry Studio

Instale o aplicativo desktop seguindo o [guia oficial de download do Cherry Studio][1] e abra suas configurações.



[1]: https://docs.cherryai.com.cn/cherry-studio/download.html

## Adicionar o provedor RunAPI

1.  Abra **Settings -> Model Services -> + Add**.
2.  Defina o nome do provedor como `RunAPI` e **Provider type** como
    **OpenAI**.
3.  Insira sua Chave de API do RunAPI e defina o endereço da API como
    `https://runapi.ai/v1`.
4.  Adicione um identificador de modelo exato do [Catálogo de Modelos](https://runapi.ai/pt-BR/models),
    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`:** use `https://runapi.ai/v1` como endereço da API; não acrescente `/chat/completions` manualmente.
* **Text funciona, mas visão ou ferramentas falham:** escolha um modelo que declare a capacidade necessária no [Catálogo de Modelos](https://runapi.ai/pt-BR/models).

Para comportamento de protocolo compartilhado, use o [Início rápido da API
LLM](https://runapi.ai/pt-BR/docs/guides/llm-api/quickstart.md). Para campos de requisição e resposta, use a [Referência da API Chat
Completions](https://runapi.ai/pt-BR/docs/api/openai/chat-completions.md).

---

## Mais de RunAPI

- [Início](https://runapi.ai/pt-BR/.md)
- [Catálogo de modelos](https://runapi.ai/pt-BR/models.md)
- [Preços](https://runapi.ai/pt-BR/pricing.md)
- [Provedores](https://runapi.ai/pt-BR/models)
- [Documentação](https://runapi.ai/pt-BR/docs/guides)
- [SDKs](https://runapi.ai/pt-BR/sdk.md)
- [CLI](https://runapi.ai/pt-BR/cli.md)
- [Servidor MCP](https://runapi.ai/pt-BR/mcp.md)
- [Claude Code vs Cursor](https://runapi.ai/pt-BR/claude-code-vs-cursor.md)
- [Configuração da API do Cursor](https://runapi.ai/pt-BR/cursor-api-setup.md)
- [RunAPI vs OpenRouter](https://runapi.ai/pt-BR/openrouter-alternative.md)
- [Enterprise](https://runapi.ai/pt-BR/contact.md)
- [Contato](https://runapi.ai/pt-BR/contact.md)
- [Termos](https://runapi.ai/pt-BR/terms.md)
- [Privacidade](https://runapi.ai/pt-BR/privacy.md)
- [Índice do site para agentes](https://runapi.ai/llms.txt)

Contato: contact@runapi.ai

## Dados estruturados

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "pt-BR",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/pt-BR",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/pt-BR/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "pt-BR",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/pt-BR",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/pt-BRicon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "pt-BR",
    "@type": "TechArticle",
    "headline": "Cherry Studio",
    "description": "Conecte o Cherry Studio ao RunAPI e verifique uma conversa.",
    "url": "https://runapi.ai/pt-BR/docs/resources/application-practices/cherry-studio",
    "mainEntityOfPage": "https://runapi.ai/pt-BR/docs/resources/application-practices/cherry-studio"
  }
]
```