Cherry Studio

Configure a base OpenAI e os modelos no Cherry Studio.

Instalação e preparação

Instale a versão Windows, macOS ou Linux pelas versões Cherry Studio e abra o app. Crie uma chave de cliente em routerra.ai/keys e copie um ID permitido da lista de modelos do gateway. Docker e inferência local são desnecessários; a chave fica nas configurações do provedor no cliente.

Configurar a conexão

Abra Settings → Model Services → + Add Provider. Use routerra.ai como nome, escolha OpenAI com URL base https://routerra.ai/v1 e informe YOUR_API_KEY. Nas versões com API Address, use https://routerra.ai/v1 e confira se a prévia resulta em /v1/chat/completions. Versões recentes separam os protocolos: configure o chat OpenAI, não Anthropic ou Responses. Salve e ative o provedor.

OpenAI base URL: https://routerra.ai/v1
API Key: YOUR_API_KEY
Model ID: YOUR_MODEL_ID
Generated chat URL: https://routerra.ai/v1/chat/completions

Selecionar um modelo e resolver erros

Use Get model list ou + para adicionar YOUR_MODEL_ID manualmente. Selecione esse provedor e modelo em um novo chat e envie um texto curto. Em erros 404, procure /v1 duplicado ou /chat/completions ausente. Se a lista estiver vazia, confira a ativação do provedor e adicione o ID exato. A verificação da chave não garante acesso a todos os modelos.