Usando o OneAster no Cherry Studio

​

Pré-requisitos

Antes de começar, certifique-se de:

1. Cherry Studio instalado
   Baixe e instale a versão adequada para o seu sistema operacional a partir do site oficial do Cherry Studio
2. Chave de API do OneAster obtida
   Acesse o Console do OneAster para obter sua chave de API (começa com sk-)

​

Etapa 1: Abrir as configurações do Cherry Studio

Após iniciar o Cherry Studio, navegue até a página de configurações:

1. Clique no ícone ⚙️ Configurações (ícone de engrenagem) no canto superior direito
2. Ou use os atalhos de teclado:
   • Windows/Linux: Ctrl + ,
   • macOS: Cmd + ,

​

Etapa 2: Adicionar a plataforma de modelos OneAster

​

2.1 Acessar o gerenciamento de serviço de modelos

Na página de configurações:

1. Encontre a opção Model Service no menu à esquerda
2. Clique para entrar na página de gerenciamento de serviço de modelos

​

2.2 Adicionar o provedor OneAster

1. Na parte inferior da página de serviço de modelos, clique no botão ”+ Add”

2. No diálogo “Add Provider”, preencha:
   • Provider Name: oneaster (personalizável)
   • Provider Type: Selecione OpenAI
3. Clique no botão “Confirm”

​

2.3 Configurar as informações da API do OneAster

Após adicionar o provedor, preencha as informações da API na área de configuração à direita:

​

Etapa 3: Adicionar e gerenciar modelos

​

3.1 Abrir o gerenciamento de modelos

Após configurar o provedor OneAster:

1. Certifique-se de que o interruptor do provedor OneAster no canto superior direito esteja ON (verde)
2. Na área de configuração à direita, encontre a seção “Models”
3. Clique no botão “Manage” para abrir a janela de seleção de modelos

​

3.2 Adicionar os modelos desejados

Na janela de seleção de modelos:

1. Use a caixa de pesquisa para encontrar modelos específicos
2. Use as abas de categoria na parte superior para filtrar: All, Reasoning, Vision, Web, Free, Embedding, Rerank, Tool
3. Encontre os modelos que deseja e clique no botão + à direita para adicionar:
   • gpt-4o / chatgpt-4o - Modelo OpenAI GPT-4o
   • gpt-4o-mini - Versão mais rápida e econômica
   • Série claude-3 - Modelos Claude 3 (com várias variantes)
   • claude_code_sonnet-4 - Claude Code Sonnet 4
   • claude_code_haiku-4 - Claude Code Haiku 4
   • gemini-2.0-flash-exp - Google Gemini 2.0 Flash

4. Após adicionar todos os modelos desejados, feche a janela de seleção de modelos

​

Etapa 4: Começar a conversar

Após a configuração, você pode começar a usá-lo:

1. Volte para a interface principal, clique no ”+” na parte superior ou selecione um chat existente
2. Na parte superior da página de chat, clique no seletor de modelos
3. Selecione um modelo sob o provedor OneAster
4. Comece a conversar com a IA!

​

FAQ

​

Q1: Não consigo me conectar ao serviço OneAster?

Solução:

1. Verifique a Base URL:
   • Certifique-se de que a Base URL seja https://api.oneaster.ai
   • Não adicione o sufixo /v1
2. Verifique a API Key:
   • Confirme que a API Key está correta e começa com sk-
   • Verifique se a chave é válida no Console do OneAster
3. Verifique a conexão de rede:
   • Certifique-se de que pode acessar https://api.oneaster.ai
   • Você pode precisar configurar um proxy se estiver na China

​

Q2: A lista de modelos está vazia ou não atualiza?

Solução:

1. Adicione modelos manualmente:
   • Se a atualização automática falhar, você pode adicionar modelos comuns manualmente
   • Na gestão de modelos, digite manualmente o nome do modelo (por exemplo, gpt-4o)
2. Verifique as permissões da API:
   • Confirme que sua API Key tem permissão para acessar a lista de modelos
   • Entre em contato com o suporte do OneAster para verificar o status da conta

​

Q3: Mensagens de erro durante a conversa?

Erros comuns e soluções:

​

Q4: Como visualizar o uso e os custos da API?

Acesse o Console do OneAster para visualizar:

• 📊 Estatísticas de chamadas de API
• 💰 Detalhes de custos
• 📈 Gráficos de tendência de uso

​

Recursos

Usando Cherry Studio + OneAster, você pode:

• 💬 Conversas multimodelo - Use diferentes modelos de IA na mesma interface
• 🖼️ Compreensão de imagens - Conversas multimodais com suporte a entrada de imagens
• 📝 Gerenciamento de contexto - Gerenciamento inteligente do histórico de conversas e contexto
• 🎨 Prompts personalizados - Crie e gerencie modelos de prompts
• 📊 Exportar conversas - Exporte registros de conversas para Markdown e outros formatos
• 🔄 Comparação de modelos - Use vários modelos simultaneamente e compare as saídas

​

Suporte e ajuda

Se você encontrar algum problema:

• 📚 Documentação do OneAster
• 💬 Comunidade do Discord
• 🐦 Twitter @oneaster_
• 📧 Suporte técnico: [email protected]

---