Configurações principais
Pré-requisitos
- A versão atual da ferramenta está instalada
- Uma BetterToken API Key: cadastre-se e crie uma
- Um ID de modelo da model plaza
Requisitos adicionais
- Dify Cloud ou uma instância auto-hospedada do Dify com plugins ativados
- Permissão para instalar plugins de modelo e gerenciar modelos do espaço de trabalho
Este guia configura somente LLM Chat. Não adicione um modelo de chat GPT como Text Embedding, Rerank, Speech-to-Text ou Text-to-Speech.
Instalação
Instale o plugin de modelo compatível com OpenAI
1
Abra Model Providers
No espaço de trabalho do Dify, acesse Integrations > Model Providers.
2
Instale o plugin oficial
Clique em Install model providers, procure por OpenAI-API-compatible e instale-o.O Dify gerencia provedores de modelo como plugins do espaço de trabalho. Após a instalação, aplicativos com as permissões necessárias poderão selecionar modelos desse provedor.
3
Adicione um modelo personalizado
No cartão OpenAI-API-compatible, clique em Add Model. Se o cartão mostrar primeiro Setup ou Configure, abra-o e escolha a opção para adicionar um modelo.
Configuração manual
Conclua essa configuração na interface de provedores de modelo do Dify. Não é necessário editar um arquivo de configuração.Informe a configuração do modelo
Use estes valores para o primeiro modelo:
Use valores conservadores para os demais recursos opcionais:
- Thinking Mode Support: ative somente após confirmar o suporte do modelo
- Stream function calling: selecione
Not Supportno primeiro teste - Vision Support: ative somente quando o modelo e o endpoint aceitarem entrada de imagem
- Structured Output: mantenha desativado até o chat simples funcionar
Use o modelo em um aplicativo
1
Crie ou abra um aplicativo do Dify
Abra um Chatbot, Agent, Chatflow ou Workflow.
2
Selecione o modelo
No seletor de modelos do aplicativo ou em um nó LLM, escolha o modelo adicionado em OpenAI-API-compatible.
3
Teste primeiro o chat simples
Execute a primeira solicitação com uma entrada de texto curta e sem ferramentas nem imagens:
4
Ative recursos do Agent depois
Depois que o chat simples funcionar, edite a configuração do modelo se precisar de chamadas de ferramenta. Defina Function Call Type para o modo aceito pelo modelo. Chamadas de ferramenta compatíveis com OpenAI geralmente usam
Tool Call, mas você precisa verificar o suporte do modelo e endpoint selecionados.Verifique a conexão
Envie um prompt de teste curto. Se a ferramenta retornar uma resposta sem erro de autenticação ou de ID de modelo, a conexão funciona. Reinicie completamente a ferramenta depois de alterar a configuração.Alterne entre modelos
Abra o seletor de modelos ou altere o campoModel na configuração. Use o ID de modelo exato da model plaza e reinicie a sessão atual.
O Dify armazena uma configuração personalizada por ID de modelo. Para adicionar outro modelo de um provedor compatível, clique novamente em Add Model no mesmo provedor. Use o novo ID tanto em Model Name quanto em model name for API endpoint. Você pode reutilizar a Base URL e a API Key.
Erros comuns
Salvar retorna 401
- Verifique se a API Key está completa
- Confirme que o ID de modelo vem de um provedor compatível
- Verifique o status e o saldo da chave no Dashboard da BetterToken
Salvar retorna 404
- A API Base URL deve ser
https://www.bettertoken.ai/v1 - Não acrescente
/chat/completions - Verifique se model name for API endpoint corresponde exatamente ao ID da model plaza
O Dify informa que o modelo não foi encontrado
Model Name pode afetar como o Dify exibe e seleciona o modelo. O modelo solicitado é controlado por model name for API endpoint. Use o mesmo ID de modelo de um provedor compatível nos dois campos.O chat simples funciona, mas as ferramentas do Agent falham
Volte Function Call Type paraNot Support e verifique um nó LLM básico. Altere para Tool Call somente se o modelo selecionado aceitar chamadas de ferramenta; depois teste novamente os argumentos.
Knowledge não pode usar este modelo como Embedding Model
Isso é esperado. Um LLM de chat não substitui um modelo de embedding. Este guia não confirma endpoints de embedding ou rerank da BetterToken para Dify; configure separadamente um provedor de embedding compatível para Knowledge.Advanced setup
Provedores compatíveis
Os status se aplicam ao método de configuração do BetterToken descrito nesta página.
O que significa cada método de configuração
O que significa cada método de configuração
- Configuração manual: informe a API Key, a Base URL e o Model.
- Sem suporte: ainda não há um método verificado de conexão direta.
Related guides
- Dify Model Providers
- Plugin oficial OpenAI-API-compatible do Dify
- API compatível com OpenAI vs. API compatível com Anthropic
- Como escolher um modelo
Detalhes técnicos
Protocolo, endpoint e campos internos do provedor
Protocolo, endpoint e campos internos do provedor
Esta configuração usa
https://www.bettertoken.ai/v1. A ferramenta acrescenta o caminho de endpoint compatível com OpenAI. Não adicione /chat/completions ou /responses, exceto quando um campo específico exigir isso.