Documentação
Msty Studio
A documentação do Msty Studio diz que é possível adicionar um endpoint compatível com OpenAI como provedor, mas não vai além disso. O próprio aplicativo dá mais detalhes: informa o tipo do provedor, os dois campos e a regra de /v1. Veja o formulário preenchido para o Kunavo.
Model Hub > Model Providers > Add Provider > Open AI Compatible: uma API Key e um Inference Endpoint de https://api.kunavo.com/v1 — a própria observação do aplicativo diz que a maioria dos endpoints compatíveis com OpenAI precisa do /v1.
Model Hub > Model Providers > Add Provider
Provider Open AI Compatible (under "OpenAI Compatible")
Name Kunavo "Give it a name (optional)"
API Key sk-kn-...
Inference Endpoint https://api.kunavo.com/v1 <- keep the /v1
Models Fetch Models, then tick the ids you want
(or Add Custom Model: Model ID + Model Name)
→ Save Provider/models e /chat/completions ao valor informado. Sem /v1, Fetch Models faz uma solicitação para https://api.kunavo.com/models e as solicitações de chat vão para https://api.kunavo.com/chat/completions; desde 1º de outubro de 2026, ambos respondem com um erro 404 em JSON cuja mensagem indica que se deve adicionar /v1 (antes disso, a busca de modelos recebia uma página da web).sk-kn-) e adicione crédito a partir de $10 — as chamadas são pagas com esse saldo, e chamadas malsucedidas não são cobradas. O painel então abre na configuração de Msty Studio.Passo a passo
- Crie uma chave em
/app/keyse copie-a — ela é exibida uma única vez. - No Msty Studio, abra Model Hub > Model Providers e selecione Add Provider. Na lista de provedores, sob o cabeçalho OpenAI Compatible, selecione Open AI Compatible — não OpenAI, que é o provedor OpenAI fixo.
- Dê um nome ao provedor, cole a chave em API Key e informe
https://api.kunavo.com/v1no campo Inference Endpoint. O aplicativo exige que o valor comece comhttps://. - Clique em Fetch Models e marque os modelos desejados. O Kunavo responde em
GET /v1/modelscom o catálogo completo, então selecione alguns, não todos. Se preferir, abra Add Custom Model e digite um Model ID exatamente como aparece no catálogo, por exemplo,claude-sonnet-5. - Clique em Save Provider, abra uma conversa e selecione um dos modelos — a própria documentação do Msty indica essa etapa como teste. Se a resposta chegar, o endpoint, a chave e o ID do modelo estão corretos.
Verificado em Página Online Providers do Msty Studio em 1 de outubro de 2026. As configurações de terceiros podem mudar; se o nome de um campo aqui já não corresponder ao que você vê, aquela página é a autoridade, não esta.
Verifique antes de depurar o cliente
Uma solicitação determina se a falha está no endpoint, na chave ou no arquivo de configuração. Se isto retornar JSON, a mesma URL base e a mesma chave funcionarão em Msty Studio.
# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
-H "Authorization: Bearer sk-kn-..."Qual ID de modelo inserir no campo
Todo modelo de texto pode ser acessado como um ID de modelo — a lista atual está em GET /v1/models, e o catálogo com preços está na página de modelos. As tarifas são em USD por 1 milhão de tokens, entrada / saída.
| ID do modelo | Entrada / saída da Kunavo | Onde se encaixa em Msty Studio |
|---|---|---|
claude-sonnet-5 | $1.40 / $7.00 | Documentos longos e conversas no Knowledge Stack: o modelo para usar como padrão na maioria das conversas |
gpt-5-6-terra | $0.70 / $4.20 | Uma segunda família em um painel de comparação de chats divididos |
claude-haiku-4-5 | $0.70 / $3.50 | Perguntas rápidas, títulos e tarefas que você executa muitas vezes |
De qual Msty estamos falando
- Msty Studio — o espaço de trabalho para desktop e web abordado nesta página, com provedores em Model Hub > Model Providers.
- Msty Go — um aplicativo de agente separado, com sua própria tela de provedores em Settings; a configuração está em sua própria página.
- Msty 1.x — o aplicativo descontinuado, cuja documentação congelada em docs.msty.app ainda aparece bem nos resultados. Suas telas não são as do Studio.
O que o aplicativo informa quando ocorre uma falha
Estas são as mensagens incluídas na versão 2.9.11 e o que cada uma significa para este endpoint:
- “O endpoint do provedor não foi encontrado. Verifique a URL do endpoint e confirme se ela inclui o caminho correto da API, como /v1.” — falta
/v1no Inference Endpoint. - “Não foi possível conectar ao endpoint do provedor…” — há um erro de digitação no host ou foi informado
http://quando deveria serhttps://. - Fetch Models falha, mas a URL está correta — verifique a chave. A lista de modelos do Kunavo exige uma chave válida e responde com 401 sem ela.
- Um modelo aparece na lista, mas o chat apresenta um erro — o formulário do próprio Msty avisa que “Nem todos os modelos foram testados com o Msty”. A lista do Kunavo inclui modelos de imagem, vídeo e áudio que não podem ser usados em uma janela de chat; escolha um modelo de chat.
O que sai da sua máquina
O Msty descreve os provedores online como uma forma de “usar modelos hospedados com suas chaves de API, sem executar a inferência do modelo no dispositivo”. Portanto, uma conversa com um modelo do Kunavo envia o prompt e o contexto anexado dessa conversa ao Kunavo, que os encaminha ao fornecedor do modelo; uma conversa com um modelo local não faz isso. Se esse limite for importante para você, mantenha materiais sensíveis em modelos locais.
Nível de esforço de raciocínio neste tipo de provedor
A documentação do Msty lista o suporte a níveis de esforço de raciocínio para “modelos compatíveis com OpenAI” como Nenhum e Padrão, enquanto o provedor nativo da Anthropic oferece Think Lightly, Moderately e Deeply. Com o tipo Open AI Compatible, espere que um modelo Claude seja executado com o raciocínio padrão, não com níveis graduados.
Perguntas frequentes
Como adiciono um provedor personalizado compatível com OpenAI no Msty Studio?
Abra Model Hub > Model Providers e selecione Add Provider. Sob o cabeçalho OpenAI Compatible, escolha Open AI Compatible, dê um nome ao provedor, cole sua chave em API Key e informe o endpoint em Inference Endpoint, incluindo o caminho da versão — para o Kunavo, https://api.kunavo.com/v1. Clique em Fetch Models para carregar a lista ou use Add Custom Model para inserir um Model ID; em seguida, clique em Save Provider. Esses rótulos são as strings da versão 2.9.11 do Msty Studio; a documentação online do Msty descreve o mesmo fluxo sem nomear os campos.
O Msty Studio exige /v1 no endpoint?
Para a maioria dos provedores compatíveis com OpenAI, sim, e o próprio aplicativo informa isso: abaixo do campo Inference Endpoint, ele mostra: “A maioria dos endpoints de provedores compatíveis com OpenAI exige o caminho /v1, por exemplo, https://example.com/v1. Se você tiver problemas, tente acrescentar /v1 ao endpoint.” O Msty Studio acrescenta apenas /models e /chat/completions; portanto, o endpoint do Kunavo é https://api.kunavo.com/v1. Sem /v1, tanto a busca de modelos quanto os chats retornam um erro 404 cuja mensagem indica que se deve adicionar /v1.
O provedor personalizado do Msty Studio é igual ao do Msty Go?
Não. São aplicativos separados, com telas de provedores distintas. No Msty Studio, os provedores são adicionados em Model Hub > Model Providers, usando o tipo Open AI Compatible descrito aqui. O Msty Go, o aplicativo de agentes anteriormente chamado Msty Claw, configura provedores em Settings > Model Providers, com seu próprio conjunto de campos. As instruções de configuração de um não se aplicam ao outro, e nenhum dos dois corresponde ao antigo aplicativo Msty 1.x, já descontinuado, cuja documentação antiga ainda aparece nos resultados de busca.
Quem me cobra quando o Msty Studio usa um provedor personalizado?
São duas partes, cobradas separadamente. A Msty cobra pelo plano do aplicativo que você usa, se houver. As chamadas ao modelo são cobradas por quem emitiu a chave no campo API Key do provedor — com uma chave Kunavo, por token, usando o saldo pré-pago da Kunavo. Os modelos locais executados dentro do Msty não têm custo por solicitação. Os planos e o custo de uma conversa típica com um documento longo, com as tarifas do catálogo, são detalhados na página de preços do Msty Studio, vinculada acima.
A Kunavo testou o Msty Studio?
Não de ponta a ponta. Em 1º de outubro de 2026, a versão oficial para desktop do Msty Studio 2.9.11 foi baixada dos servidores da Msty e analisada sem ser iniciada: o tipo de provedor, os rótulos dos campos, a observação sobre /v1, as mensagens de erro e os caminhos de solicitação desta página vêm dela. O lado da Kunavo foi verificado com solicitações HTTP diretas. Nenhuma conversa do Msty Studio com a Kunavo foi executada; portanto, o streaming, o uso de ferramentas e a entrada de imagens por meio deste provedor não foram verificados.