Dify

O Dify é uma plataforma para criar apps de LLM — chatbots, workflows e agentes — num editor visual. O provedor de modelo OpenAI-API-compatible aceita uma base URL personalizada, então seu stack aparece em todos os seletores de modelo do workspace.

Pré-requisitos#

• Uma chave da página Chaves de API do seu stack. Veja Autenticação.
• O id do modelo que você quer chamar — veja Modelos. Os exemplos abaixo usam qwen/qwen3.5-9b.
• Permissão de admin do workspace no Dify, para adicionar um provedor de modelo.

Adicione o modelo#

1. Abra os provedores de modelo

   Clique no seu avatar → Settings → Model Provider. Nas versões mais recentes, a mesma página fica em Integrations → Model Provider.

2. Instale o OpenAI-API-compatible

   Desde o Dify 1.0, provedores são plugins. Se o OpenAI-API-compatible não aparecer na lista, instale-o pela seção Marketplace da mesma página.

3. Adicione um modelo

   No card do provedor, clique em Add Model e preencha:

   Campo	Valor
   Model Type	LLM
   Model Name	qwen/qwen3.5-9b
   API Key	Sua chave do Stac
   API Base URL	https://api.trystac.com/v1
   Completion mode	Chat
   Model context size	Aumente — o padrão do Dify, 4096, é pequeno demais
   Function Call Type	Tool Call, se o modelo suportar tool calling; caso contrário, deixe Not Support

   Deixe os outros campos no padrão. Versões mais antigas do plugin chamam o campo de URL de API endpoint URL.

4. Salve

   O Dify valida as credenciais com uma chamada de teste antes de salvar. Um modelo salvo significa que a chave e a URL funcionam.

Exemplo#

Crie um app Chatbot, escolha qwen/qwen3.5-9b no seletor de modelo no canto superior direito do editor e envie uma mensagem no painel Debug and Preview:

Você:       Name three primary colors.
Assistant:  Red, blue, and yellow.

A requisição aparece em Uso e Registros no dashboard, como a de qualquer outro cliente.

Limitações#

• O nome do modelo precisa estar no seu plano. Digite em Model Name o valor exato de Modelos; um modelo que o plano da sua chave não inclui devolve 403.
• Agentes precisam de tool calling. Apps de agente e nodes de agente só chamam tools quando o Function Call Type está definido e o modelo suporta tool calling.
• Chamadas bloqueantes longas estouram o tempo. Apps com streaming funcionam normalmente; um node de workflow que espera a resposta inteira falha com 503 se a geração passar de cerca de 90 segundos.
• Instruções desligam a busca automática. Quando o app tem instruções, o Dify as envia como mensagem system, e uma chave em Automático passa a pular a base de conhecimento. Deixe-a como Ativada na chave usada pelo Dify.
• Uma completude por requisição, logit_bias é descartado e o rate limit é por chave. Veja Diferenças que importam.

Próximos passos#

• Compatibilidade OpenAI — com o que o provedor está conversando, e o que difere da OpenAI.
• Base de conhecimento — quando usar a busca do Stac em vez do recurso de conhecimento do Dify.
• Erros e limites de uso — quais códigos de status repetir.