Pular para o conteúdo
Recursos para Desenvolvedores
Recursos para Desenvolvedores

Jan

Adicione o RunAPI como provedor no Jan e verifique um chat.

Ver Markdown

Conecte o Jan ao RunAPI com um provedor compatível com OpenAI personalizado. Crie uma Chave de API padrão do RunAPI no Guia de Autenticação antes de continuar.

Instalar Jan

Baixe e instale o aplicativo desktop no site oficial do Jan, depois abra suas configurações.

Adicionar o provedor RunAPI

  1. Abra Settings -> Model Providers -> Add Provider.
  2. Defina o formato da API como OpenAI-compatible e o nome do provedor como RunAPI.
  3. Defina a Base URL como https://runapi.ai/v1, insira sua Chave de API do RunAPI e crie o provedor.
  4. Selecione um modelo descoberto ou adicione um identificador exato do Catálogo de Modelos na área Models do provedor.

O formato de API selecionado é compatível com OpenAI, portanto esta URL Base inclui /v1. Um provedor que utilize outro protocolo público deve usar a configuração de cliente própria daquele protocolo.

Quando o provedor é salvo, o Jan solicita {base_url}/models, que resolve para https://runapi.ai/v1/models. Se o modelo que você precisa não for retornado, use a ação manual + em vez de alterar a Base URL.

Configurar capacidades do modelo

O Jan não infere todas as capacidades para um provedor personalizado. Habilite apenas o comportamento de visão, ferramentas ou áudio que o modelo selecionado declara no Catálogo de Modelos. Um botão da interface não pode adicionar uma capacidade de API não suportada.

Verificar a conexão

Inicie um novo chat, selecione o modelo RunAPI e envie Reply with the word connected. Uma resposta normal completa ou em streaming confirma que o provedor e o modelo estão ativos.

Solucionar problemas

  • Toda requisição retorna 404: certifique-se de que a URL base inclui /v1; o Jan anexa o caminho da operação.
  • Nenhum modelo aparece: confirme que a URL base é https://runapi.ai/v1 e adicione o identificador de modelo exato manualmente.
  • A criação do provider retorna 401 ou 403: substitua a chave por uma Chave de API RunAPI padrão válida, não uma Management Key.
  • Os controles de capacidade não correspondem ao modelo: configure cada modelo personalizado a partir de suas capacidades declaradas em vez de depender da detecção automática.
  • Uma chave de fallback não é tentada: o Jan rotaciona chaves para 401, 403 ou 429; outros erros não acionam a rotação de chaves.

Para comportamento de protocolo compartilhado, use o Início rápido da API LLM. Para campos de requisição e resposta, use a Referência da API Chat Completions.