Dify com BetterToken: API Key, Base URL e modelos

Para conectar o Dify à BetterToken, prepare uma API Key, informe a Base URL abaixo e escolha um ID de modelo atual na model plaza.

Configurações principais

Campo	Valor
API Key	BetterToken API Key
Base URL	https://bettertoken.ai/v1
Modelo	Um ID de modelo atual da model plaza

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

Cadastre-se e obtenha uma BetterToken API Key→

Já tem uma conta? Entre, recarregue o saldo e crie uma chave no console.

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

Abra Model Providers

No espaço de trabalho do Dify, acesse Integrations > Model Providers.

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.

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.

Campo	Valor
API Key	BetterToken API Key
Base URL	https://bettertoken.ai/v1
Modelo	Um ID de modelo atual da model plaza

Informe a configuração do modelo

Use estes valores para o primeiro modelo:

Campo do Dify	Valor recomendado
Model Type	LLM
Model Name	um ID de modelo disponível na model plaza
Model display name	o mesmo valor de Model Name é suficiente
API Key	sua BetterToken API Key
API Base URL	https://bettertoken.ai/v1
model name for API endpoint	o mesmo ID de modelo de Model Name
Completion mode	Chat
Model context size	use o valor do modelo selecionado; se não tiver certeza, mantenha o padrão do plugin
Upper bound for max tokens	não exceda o modelo selecionado; mantenha o padrão do plugin no primeiro teste
Compatibility mode	OpenAI compatible / strict
Token parameter name	Auto
Function Call Type	Not Support no primeiro teste

Informe somente https://bettertoken.ai/v1 como API Base URL. Não acrescente /chat/completions; o plugin do Dify chama o endpoint necessário.

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 Support no 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

Mantenha Include Usage in Stream (stream_include_usage) no padrão Enabled. Isso adiciona stream_options: {include_usage: true} para retornar a contagem de tokens no último bloco do fluxo; desative apenas se o endpoint rejeitar esse campo. Stream mode auth (stream_mode_auth) usa Not Use por padrão. Ao escolher Use, a validação da credencial passa a usar uma solicitação em streaming, sem alterar as configurações normais de geração. Consulte os campos oficiais do provedor.

Clique em Save. O Dify valida a API Key, a Base URL e o ID de modelo.

Use o modelo em um aplicativo

Crie ou abra um aplicativo do Dify

Abra um Chatbot, Agent, Chatflow ou Workflow.

Selecione o modelo

No seletor de modelos do aplicativo ou em um nó LLM, escolha o modelo adicionado em OpenAI-API-compatible.

Teste primeiro o chat simples

Execute a primeira solicitação com uma entrada de texto curta e sem ferramentas nem imagens:

Reply with exactly: Connection successful

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 campo Model 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 disponí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
• Copie o Model ID exato da model plaza.
• Verifique o status e o saldo da chave no Dashboard da BetterToken

Salvar retorna 404

• A API Base URL deve ser https://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 disponível nos dois campos.

O chat simples funciona, mas as ferramentas do Agent falham

Volte Function Call Type para Not 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

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

• Compare as ferramentas compatíveis

• Erros da API, códigos de status e limites de requisições

Detalhes técnicos

Protocolo, endpoint e campos internos do provedor

Esta configuração usa https://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.