--- title: "Integração com Dify" description: "Configure a 1折AI usando o plugin oficial OpenAI-API-compatible do Dify, cobrindo a configuração do modelo, testes de conversa e solução de problemas da primeira chamada." headingIds: {"Pré-requisitos":"section-1","Adicionando um modelo":"section-2","Começando pela primeira conversa":"section-3","Importando o Chatflow de exemplo":"section-4","Solução de problemas":"section-5","Obtendo ajuda na integração":"section-6","Escopo de verificação":"section-7","English / Русский":"section-8"} --- Usuários do Dify podem configurar o endpoint compatível com OpenAI da 1折AI por meio do plugin oficial de modelo **OpenAI-API-compatible**. Primeiro verifique um modelo de texto e depois use-o nos fluxos de trabalho; não é necessário instalar plugins de terceiros não verificados. ## Pré-requisitos - Um espaço de trabalho do Dify onde plugins de modelo possam ser instalados. - Sua própria chave de API da 1折AI, além dos IDs de modelo que essa chave está autorizada a chamar. Verifique o [console](https://1zheai.com/console). - Saldo disponível suficiente em sua conta. A solicitação de validação ao salvar um modelo e os testes de aplicativo podem incorrer em cobranças normais de API. Não envie sua chave completa ao suporte ao cliente, não a escreva em descrições de fluxos de trabalho, capturas de tela ou repositórios públicos. Armazene-a apenas no campo de chave de API do Dify; se você usar um Dify hospedado por terceiros, essa instância mantém sua chave e encaminha as solicitações. ## Adicionando um modelo 1. No marketplace de plugins do Dify, localize **OpenAI-API-compatible** e confirme que o publicador é **langgenius**. 2. Abra os provedores de modelo nas configurações do espaço de trabalho, localize este plugin e adicione um modelo LLM. 3. Preencha os campos abaixo e salve. Os rótulos da interface podem variar conforme a versão do Dify. | Campo | Como preencher | | --- | --- | | Nome do modelo | Copie o ID completo do modelo do console da 1折AI; não substitua pelo nome de exibição | | Chave de API | Sua própria chave da 1折AI | | URL base da API | `https://1zheai.com/v1` | | Modo de conclusão | `Chat` | | Nome do modelo no endpoint da API | Geralmente deixe em branco; se definido, deve corresponder ao ID real do modelo | | Tamanho de contexto do modelo | Preencha de acordo com a capacidade real do modelo selecionado; não copie o comprimento de contexto de outro modelo | Aqui você precisa de `/v1`. Não insira o `/v1/chat/completions` completo e não o duplique como `/v1/v1`. Não aplique instruções de outros clientes que exigem apenas o endereço raiz. ## Começando pela primeira conversa Crie um aplicativo de chat em branco, selecione o modelo que você acabou de salvar e digite "Por favor, apresente em uma frase, em chinês, o que você pode fazer." Assim que uma resposta de texto completa for confirmada, verifique em seguida a saída em streaming. Verifique o tempo de solicitação correspondente, o modelo e o resultado nos registros de chamadas do console da 1折AI. Não confie apenas no "Salvo com sucesso" do Dify como prova de que o aplicativo está conectado. Somente após o primeiro sucesso você deve configurar chamadas de ferramentas, entrada de visão ou recuperação de base de conhecimento; esses recursos dependem do modelo e da interface específicos, e uma conversa de texto bem-sucedida não significa que tudo esteja disponível. ## Importando o Chatflow de exemplo [Baixe o modelo de Chatflow sem chave](/pt/docs/downloads/1zheai-dify-chatflow.yml) e, no Dify Studio, escolha **Criar → Importar arquivo DSL** para enviá-lo. O modelo é `User Input → LLM → Answer`, versão DSL 0.7.0, usando o plugin compatível oficial 0.0.68. Primeiro adicione suas próprias credenciais seguindo as etapas acima. Após a importação, abra o nó LLM e confirme que seu provedor e modelo próprios estão selecionados, e não o modelo de teste do Dify. O ID de modelo de exemplo é `claude-haiku-4-5-20251001`; se não estiver disponível para sua conta, troque por um modelo ao qual você tenha acesso e verifique as configurações de capacidade. O modelo não contém chave de API e não fornece créditos de chamada gratuitos. ## Solução de problemas | Sintoma | O que verificar primeiro | | --- | --- | | 503 / Sem contas disponíveis | O upstream atual pode estar com limite de taxa ou sem capacidade. Verifique primeiro o status do serviço e os registros de chamadas, tente novamente mais tarde com backoff ou entre em contato com o suporte; não tente novamente com alta frequência continuamente e não regenere chaves repetidamente | | 401 / Chave inválida | Se há espaços extras, se a chave foi revogada e se uma chave de outra plataforma foi usada por engano | | 404 | Se a URL base é exatamente `https://1zheai.com/v1`; se o ID do modelo existe | | Modelo não permitido ou saldo insuficiente | As restrições de modelo da chave atual, o saldo disponível da conta e o modelo selecionado | | Salvo com sucesso, mas o aplicativo não consegue chamar | Se o aplicativo selecionou o provedor e o modelo corretos; se o servidor do espaço de trabalho consegue acessar a API | | Respostas normais funcionam, streaming falha | Verifique o suporte SSE do proxy, a versão do plugin e a configuração de uso de streaming; mantenha um erro redigido para solução de problemas | | Chamadas de ferramentas ou visão falham | Primeiro confirme se o modelo selecionado realmente suporta essa capacidade; evite forçá-la apenas alternando interruptores do plugin | Solicitações de um Dify auto-hospedado são enviadas pelo seu servidor; o fato de seu navegador poder abrir o site oficial não significa que o servidor do Dify consiga conectar-se à API. ## Obtendo ajuda na integração Forneça a versão do Dify, a versão do plugin, o ID do modelo, o carimbo de data/hora do erro, o ID da solicitação e os detalhes do erro redigido por meio do atendimento ao cliente online do site oficial. Não envie a chave completa, dados de clientes ou prompts privados de seus fluxos de trabalho. ## Escopo de verificação Em 2026-10-19, usando o plugin oficial 0.0.68, a conversa de texto e as chamadas em streaming do Haiku foram concluídas no Dify Cloud e conferidas com os registros do gateway. O DSL sem chave exportado foi importado no mesmo espaço de trabalho como um novo aplicativo. Após a importação, um novo teste encontrou um 503 causado por limite de taxa upstream, portanto esta rodada não é registrada como uma execução pós-importação aprovada. Este é um teste interno com uma janela de tempo definida, não uma garantia contínua de disponibilidade. Espaços de trabalho novos, versões mais antigas do Dify, chamadas de ferramentas, visão e recuperação de base de conhecimento não foram verificados; conclua seu primeiro teste com sua própria chave com limite de taxa. [Fonte do plugin oficial](https://github.com/langgenius/dify-official-plugins/tree/main/models/openai_api_compatible) · [Marketplace de plugins do Dify](https://marketplace.dify.ai/) ## English / Русский **English:** Install the official OpenAI-API-compatible plugin by langgenius. Set API Base URL to `https://1zheai.com/v1`, use your own API key and an exact model ID available to your account, and select Chat mode. Test a simple conversation before adding tools or vision. Text and streaming calls were verified in Dify Cloud on 2026-10-19. DSL import into a new app in the same workspace succeeded; its subsequent run encountered an upstream-capacity 503. Fresh-workspace import and advanced capabilities remain unverified. Never share your key with support. **Русский:** Установите официальный плагин OpenAI-API-compatible от langgenius. Укажите API Base URL `https://1zheai.com/v1`, собственный API-ключ и точный ID модели, доступной вашему аккаунту; выберите режим Chat. Сначала проверьте простой диалог, затем потоковый вывод. Текстовые и потоковые вызовы проверены в Dify Cloud 19 октября 2026 года. Импорт DSL в новое приложение того же рабочего пространства прошёл, но повторный вызов вернул 503 из-за недоступной мощности upstream. Новое рабочее пространство и расширенные функции ещё не проверены. Не отправляйте ключ службе поддержки. Доступность из конкретной сети и способы оплаты проверяются отдельно.