Dify - Alibaba Cloud Model Studio

Pré-requisitos

É necessário get an API key e ativar os service de modelo necessários no Model Studio.

Como o Dify é uma plataforma de fluxo de trabalho e automação, ele não oferece suporte ao Token Plan Personal Edition, Token Plan Team Edition ou Coding Plan. Esses planos são compatíveis apenas com ferramentas de programação por IA e agentes do tipo OpenClaw. Para mais informações, consulte Unsupported tool types.Utilize uma chave de API com pagamento conforme o uso no Dify. O uso de uma chave de API de plano para chamadas fora do escopo permitido será considerado uma violação ou abuso, podendo resultar na suspensão da assinatura ou no banimento da chave de API.

1. Configurar o modelo

1,1. Instalar o provedor de modelos

Acesse o Dify Marketplace. Em Model, localize o Qwen e instale a versão mais recente do plugin.

O plugin TONGYI é mantido pelo Dify, não pela Alibaba Cloud. Caso encontre um erro ao instalar a versão mais recente, tente instalar uma versão anterior.
Para utilizar modelos DeepSeek do Model Studio, também é necessário usar o plugin Qwen.

1,2. Configurar a chave de API

No canto superior direito da página, clique em sua foto de perfil → Settings. Em Model Providers, localize o cartão Qwen e clique em Settings.

Ao utilizar um modelo da região Singapore, vá para a seção API-KEY Settings, insira a chave de API dessa região e defina Use International Endpoint como Yes.
Para modelos da região Beijing, acesse a seção API-KEY Settings, insira a chave de API correspondente à região Beijing e defina Use International Endpoint como No.

Se você receber o erro Invalid API key provided durante a configuração, consulte a nota sobre versões de plugins em 1,1. Instalar o provedor de modelos .

1,3. Selecionar um modelo

No cartão Qwen, clique para exibir a lista de modelos e ative a opção correspondente aos modelos desejados.

Caso o plugin não inclua o modelo Qwen mais recente, instale o plugin OpenAI-API-compatible . Nas configurações do plugin, defina a API endpoint URL como uma das seguintes opções: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 (região Singapore) ou https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1 (região Beijing) . Substitua WorkspaceId pelo seu Get the Workspace ID real.

2. Primeiros passos

O Dify oferece suporte a diversos tipos de aplicação. Selecione a sua para ver as instruções correspondentes.

Chat assistant and agent
Chatflow and workflow
Knowledge base

Criar um assistente de chat ou agente No workspace, clique em Create blank app. Em Beginner-Friendly, crie e abra um assistente de chat ou agente.
Selecionar um modelo No canto superior direito da página da aplicação, selecione um modelo. Por exemplo, em Qwen, escolha qwen-plus-latest(Qwen3) e ative o modo de raciocínio.
Testar a conversa Insira "Who are you?". O modelo responderá após concluir o processo de raciocínio. Também é possível utilizar um modelo Qwen-VL ou QVQ para fazer perguntas sobre imagens. Após selecionar um modelo de visão, a opção Vision aparecerá à esquerda. Ative-a para enviar imagens na janela de chat à direita.

Criar um Chatflow ou workflow No workspace, crie e abra um Chatflow ou workflow.
Adicionar um nó LLM Adicione um nó LLM ao canvas. Selecione o nó para abrir seu painel de edição e escolha o modelo desejado. Neste exemplo, selecione qwen-plus-2025-07-28(Qwen3) e ative o modo de raciocínio. Caso esteja utilizando um modelo Qwen-VL ou QVQ, é obrigatório ativar a opção Vision no nó LLM: Na parte inferior do painel de edição do nó LLM, localize e ative a opção Vision. Em seguida, defina a Resolution como High ou Low.
Executar o nó LLM Clique em Add message. No campo de mensagem correspondente a USER, insira a pergunta "Who are you?" e clique no botão de execução no canto superior direito do nó. Após a conclusão da execução, inspecione o campo text na saída. O processo de raciocínio vem delimitado pelas tags <think>...</think>, seguido pela resposta principal do modelo. O campo text retornado pelo nó LLM contém tanto o processo de raciocínio quanto a resposta. É possível utilizar um nó de execução de código do Dify com expressões regulares para extraí-los separadamente.

FAQ

P1: Erro de chave de API no plugin TONGYI

R: Motivos comuns:

A versão mais recente do plugin pode apresentar instabilidade. Consulte a nota sobre versões de plugins em 1,1. Instalar o provedor de modelos.
Você está utilizando uma chave de API de um sub-workspace. A versão 0.0.41 do plugin TONGYI valida as permissões de invocação do modelo qwen-turbo. É necessário grant invocation permission para o modelo qwen-turbo.
O plugin TONGYI não é mantido pela Alibaba Cloud, e suas políticas de validação podem mudar em versões futuras. Utilize uma chave de API do workspace padrão.
A configuração do endpoint está incorreta. Defina Use International Endpoint corretamente com base na região da sua chave de API.

P2: Uso dos modelosQwen-Omni e Qwen-OCR

R: Esses modelos não podem ser configurados diretamente no Dify. A integração é feita por meio de um nó HTTP em um Chatflow ou workflow. Para detalhes sobre a integração, consulte os exemplos de comandos curl na documentação do modelo.

Para reduzir o risco de timeouts no nó HTTP, utilize saída em streaming nas chamadas de API.

P3: Uso de modelos Wan

R: O Dify não oferece um plugin dedicado para modelos Wan. No entanto, é possível realizar geração de texto para imagem e texto para vídeo utilizando nós em um Chatflow ou workflow do Dify. Siga estas etapas:

Baixar e importar um modelo de workflow Baixe um de nossos modelos pré-construídos: Wan - Text-to-Image Demo.yml ou Wan - Text-to-Video Demo.yml. No workspace, clique em Import DSL File e selecione o modelo baixado.
Configurar variáveis de ambiente Na página do workflow, localize o ícone de variáveis de ambiente e altere o valor de DASHSCOPE_API_KEY para a sua chave de API.
Testar a saída Clique no botão Run para gerar a saída. Por exemplo, ao inserir "a small cat" no workflow de texto para imagem, uma imagem será produzida.
O workflow de texto para vídeo retorna uma URL para o vídeo gerado.

A geração de texto para vídeo geralmente leva cinco minutos ou mais.
Publicar como ferramenta (opcional) Para utilizar esses recursos em outras aplicações, clique em Publish no canto superior direito e selecione Publish as tool.

Os modelos utilizam modelos da região Singapore : wan2.2-t2i-flash (texto para imagem) e wan2.1-t2v-turbo (texto para vídeo). É possível alterar o modelo no nó STEP1 e modificar o endpoint de API específico da região nos nós STEP1 e STEP3.

P4: Implantação privada do Dify

R: O service de cloud do Dify possui algumas limitações, como o máximo de cinco aplicações. Para realizar uma implantação privada, consulte Alibaba Cloud solution for Dify deployment.

​Pré-requisitos

​1. Configurar o modelo

​1,1. Instalar o provedor de modelos

​1,2. Configurar a chave de API

​1,3. Selecionar um modelo

​2. Primeiros passos

​FAQ

​P1: Erro de chave de API no plugin TONGYI

​P2: Uso dos modelosQwen-Omni e Qwen-OCR

​P3: Uso de modelos Wan

​P4: Implantação privada do Dify