Integração com Dify
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.
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
Seção intitulada "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.
- 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
Seção intitulada "Adicionando um modelo"- No marketplace de plugins do Dify, localize OpenAI-API-compatible e confirme que o publicador é langgenius.
- Abra os provedores de modelo nas configurações do espaço de trabalho, localize este plugin e adicione um modelo LLM.
- 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
Seção intitulada "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
Seção intitulada "Importando o Chatflow de exemplo"Baixe o modelo de Chatflow sem chave 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
Seção intitulada "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
Seção intitulada "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
Seção intitulada "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 · Marketplace de plugins do Dify
English / Русский
Seção intitulada "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. Новое рабочее пространство и расширенные функции ещё не проверены. Не отправляйте ключ службе поддержки. Доступность из конкретной сети и способы оплаты проверяются отдельно.