Documentação

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.

Msty Studio 2.9.11 — Add Provider
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
Mantenha o /v1 — o próprio Msty diz isso. Abaixo do campo Inference Endpoint, o aplicativo mostra: “A maioria dos endpoints de provedores compatíveis com OpenAI exige o caminho /v1, por exemplo, https://example.com/v1.” O Msty Studio acrescenta apenas /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).
De onde vêm esses rótulos. A documentação online do Msty não informa os nomes dos campos. Os rótulos acima são as strings incluídas na versão 2.9.11 para desktop do Msty Studio (baixada dos servidores do próprio Msty em 1º de outubro de 2026 e consultada sem iniciar o aplicativo), portanto correspondem ao que o aplicativo exibe em inglês. Uma versão futura pode reformulá-los; o aplicativo na sua tela é a referência.
Não foi testado de ponta a ponta. Ninguém aqui enviou uma mensagem do Msty Studio ao Kunavo. O formulário de provedor, a observação sobre /v1 e os caminhos das solicitações foram consultados na versão lançada, e o lado do Kunavo foi verificado com solicitações HTTP simples. Streaming, chamadas de ferramentas, entrada de imagens e controles de raciocínio por meio desse tipo de provedor não foram testados — sua primeira conversa é a verificação real.
Ainda não tem uma chave? Crie uma conta na Kunavo, gere uma chave (ela começa com 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

  1. Crie uma chave em /app/keys e copie-a — ela é exibida uma única vez.
  2. 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.
  3. Dê um nome ao provedor, cole a chave em API Key e informe https://api.kunavo.com/v1 no campo Inference Endpoint. O aplicativo exige que o valor comece com https://.
  4. Clique em Fetch Models e marque os modelos desejados. O Kunavo responde em GET /v1/models com 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.
  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.

Esta é a versão resumida. O guia completo — escolha do modelo, custo de uma sessão real e modos de falha — está em Preços do Msty Studio e custo da API.

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 modeloEntrada / saída da KunavoOnde se encaixa em Msty Studio
claude-sonnet-5$1.40 / $7.00Documentos longos e conversas no Knowledge Stack: o modelo para usar como padrão na maioria das conversas
gpt-5-6-terra$0.70 / $4.20Uma segunda família em um painel de comparação de chats divididos
claude-haiku-4-5$0.70 / $3.50Perguntas rápidas, títulos e tarefas que você executa muitas vezes
A cobrança é por token, usando um saldo pré-pago e sem tarifa mensal — consulte billing. Em contextos repetidos — que representam a maior parte do que um editor ou cliente de chat envia — o cache de prompt altera a conta mais do que a escolha do modelo.

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 /v1 no 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 ser https://.
  • 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.