Quando usar um provedor próprio
O Deskgram pode conectar um serviço AI com API compatível e disponibilizar seus modelos nos módulos com suporte a AI. Você precisa da URL base, chave e identificadores exatos dos modelos. O nome cadastrado é um rótulo, não uma confirmação de compatibilidade.
A implementação usa /models para listar modelos e /chat/completions para gerar texto. O serviço pode exigir autenticação, resposta ou parâmetros diferentes. A indicação “OpenAI-compatible” não garante funcionamento por si só.
Preparar o acesso
Consulte a documentação API do fornecedor, crie uma chave com as permissões necessárias e confira cobrança, modelos e limites. Assinatura de chat no navegador pode não incluir API.
https://provider.example/v1 é um exemplo de raiz API, não um serviço real. Não cole o caminho completo /chat/completions em Base URL: o Deskgram acrescenta a operação. Use raiz e versão documentadas pelo fornecedor.
Não exponha a chave em suporte ou capturas de tela. Se ela vazar, revogue-a no painel e substitua o valor no programa.
Cadastrar conexão e modelos
- Abra Configurações → API → provedores próprios e o formulário de adição.
- Digite um nome reconhecível.
- Preencha Base URL e API Key.
- Adicione ao menos um modelo. O ID deve ser o identificador técnico exato; o nome amigável opcional não o substitui nas solicitações.
- Com vários modelos, marque o padrão pela estrela. O primeiro adicionado começa como padrão; revise antes de salvar.
- Ative suporte a saldo somente para uma conexão que realmente permita a consulta. A opção não cria uma API universal de saldo.
O que o Test verifica
Primeiro tenta obter a lista de modelos. Você pode adicionar os encontrados individualmente ou todos e conferir IDs e padrão. A lista obtida não comprova permissão de geração para cada modelo.
Se a lista não estiver disponível, mas você tiver informado um modelo padrão manualmente, o teste pode enviar uma geração curta. Ela consome cota e pode ser cobrada. Se desconhecer o ID, procure na documentação, adicione e repita o teste.
Após verificar, salve. São obrigatórios nome, URL, chave e ao menos um ID de modelo. Escolha então provedor e modelo no módulo AI desejado.
Teste uma geração curta separadamente: idioma, formato e ausência de erro. Use a prévia do módulo, se houver. Caso contrário, valide primeiro o modelo no console API do fornecedor e faça uma execução pequena com seus dados de teste. Não envie resultados experimentais a terceiros. Essa verificação é diferente de obter a lista de modelos.
Falhas, cobrança e fallback
Confira raiz e versão API, chave, permissões, ID exato, cota e resposta no registro. Alterar o nome visível não corrige ID inválido. Repetir pedidos não substitui recarga de saldo ou ajuste de limites.
Vários modelos no cartão permitem escolhê-los; não prometem troca automática entre todos os modelos ou provedores próprios após uma falha. Provedores integrados têm lógica de fallback separada, que não deve ser presumida para qualquer conexão.
Preço, cotas gratuitas e limites dependem do fornecedor API. Preço zero ou ausente na interface não significa geração gratuita. Isso também vale para Mistral: confira acesso, cobrança e limites atuais. Um teste bem-sucedido não garante respostas futuras sem erro.
Capturas da interface
As imagens usam a interface russa. O layout pode variar; siga os campos descritos acima. Imagens antigas podem não mostrar os novos controles de modelos e padrão.
