新增国内直连 Base URL： https://api.highwayapi.ai/openai，原域名继续提供服务，详见产品文档

Dify接入API中转服务教程：国内使用Claude和GPT构建工作流

Category: Technical ExchangePublished:建议阅读时长：14 分钟
Author: sodope llm

引言

Dify 是目前国内最受欢迎的开源 LLM 应用开发平台之一，提供了可视化的工作流编排、RAG 知识库、对话应用等强大功能，让开发者无需深入掌握 AI 底层就能快速构建智能应用。

然而，Dify 默认需要接入 OpenAI、Anthropic 等海外 API，对国内用户来说存在网络限制。本教程将手把手教你如何通过 API 中转服务，在国内顺畅地将 Claude 和 GPT 接入 Dify，构建你的 AI 工作流。

Dify 简介

Dify 是一个开源的 LLM 应用开发平台，主要功能包括：

  • 对话应用：快速搭建智能客服、问答机器人
  • 工作流编排：可视化拖拽式 AI 流程设计
  • RAG 知识库：上传文档构建专属知识库
  • Agent 模式：赋予 AI 工具调用能力
  • API 开放：一键将应用发布为 API 服务

无论是个人开发者还是企业团队，Dify 都是构建 AI 应用的利器。

为什么需要 API 中转？

国内开发者在使用 Dify 时面临的主要问题：

  1. 网络限制：OpenAI、Anthropic 官方 API 在国内无法直连
  2. 支付门槛：需要海外信用卡才能注册和付费
  3. 延迟高：即使通过代理，网络延迟也影响工作流稳定性

通过 API 中转服务，这些问题迎刃而解。

jiekou.ai —— 国内最佳 Dify API 中转方案

jiekou.ai 专为国内开发者设计，完美适配 Dify 的接入需求：

  • ✅ 国内直连：无需翻墙，稳定低延迟
  • ✅ OpenAI 兼容格式：Dify 原生支持，零配置改动
  • ✅ 模型全覆盖：GPT-4o、Claude 3.5/3.7 Sonnet、Gemini、DeepSeek 等
  • ✅ 按量计费：轻度使用成本极低
  • ✅ 企业级稳定性：适合生产环境

核心接口信息：

  • Base URL：https://api.jiekou.ai/v1
  • API Key：在 jiekou.ai 控制台获取

Dify 接入 API 中转详细步骤

第一步：部署 Dify

方式一：本地 Docker 部署（推荐）

# 克隆 Dify 仓库
git clone https://github.com/langgenius/dify.git
# 进入 docker 目录
cd dify/docker
# 复制环境变量文件
cp .env.example .env
# 启动服务
docker compose up -d

访问 http://localhost 即可打开 Dify 控制台。

方式二：使用 Dify Cloud

访问 cloud.dify.ai 注册账号，直接使用在线版本。

第二步：进入模型供应商设置

  1. 登录 Dify 控制台
  2. 点击右上角头像 → 设置
  3. 在左侧菜单选择 模型供应商

第三步：添加 OpenAI 兼容模型

在模型供应商列表中，找到 OpenAI-API-compatible 或直接选择 OpenAI：

填写配置：

字段值
API Key你的 jiekou.ai API Key
API Base URLhttps://api.jiekou.ai/v1
Model Name见下方模型列表

支持的模型（在 Dify 中添加）：

GPT-4O
GPT-4o-mini
claude-3-5-sonnet-20241022
claude-3-7-sonnet-20250219
claude-3-haiku-20240307
gemini-1.5-pro
deepseek-chat

第四步：验证模型连接

配置完成后，点击”连通性检测”按钮，如果显示绿色”已连接”状态，说明配置成功。

第五步：创建你的第一个工作流

配置好模型后，你可以：

  1. 点击顶部菜单 工作室 → 创建空白应用
  2. 选择工作流类型
  3. 在工作流画布中添加 LLM 节点
  4. 在 LLM 节点中选择你刚才添加的 Claude 或 GPT 模型
  5. 设计你的工作流逻辑

实战案例：构建文章摘要工作流

下面以一个简单的文章摘要工作流为例，展示 Dify + Claude 的强大能力。

工作流结构

[开始] → [LLM：文章摘要] → [结束]

LLM 节点配置

  • Model:claude-3-5-sonnet-20241022
  • System Prompt：
你是一个专业的文章摘要助手。请对用户提供的文章进行摘要，要求：
1. 摘要长度：200字以内
2. 保留核心观点和关键信息
3. 使用简洁的中文表达
  • User Message:{{article}} （变量引用）

通过 API 调用此工作流

Dify 将工作流发布为 API 后，可以通过以下代码调用：

import requests
# Dify Workflow API 调用示例
url = "http://localhost/v1/workflows/run"
headers = {
    "Authorization": "Bearer YOUR_DIFY_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "inputs": {
        "article": "你要摘要的文章内容..."
    },
    "response_mode": "blocking",
    "user": "user-001"
}
response = requests.post(url, headers=headers, json=payload)
result = response.json()
print(result["data"]["outputs"])

进阶：配置 RAG 知识库

Dify 的 RAG 功能配合 Claude 使用效果极佳，适合构建企业知识库问答系统。

配置步骤

  1. 上传知识库文档：在 Dify 的”知识库”模块上传 PDF、Word、TXT 等文档
  2. 配置向量模型：选择 Embedding 模型（推荐 text-embedding-3-small，通过 jiekou.ai 调用）
  3. 创建问答应用：在应用中绑定知识库，选择 Claude 作为生成模型
  4. 调优参数：调整 Top K、相似度阈值等 RAG 参数

Embedding 模型配置（jiekou.ai）

# 在 Dify 的 Embedding 设置中填入：
API Key: 你的 jiekou.ai API Key
Base URL: https://api.jiekou.ai/v1
Model: text-embedding-3-small

Frequently Asked Questions

Q：Dify 提示”模型不存在”怎么办？

确保模型名称与 jiekou.ai 支持的模型列表完全一致，可在 jiekou.ai 控制台的”模型列表”中查看最新支持的模型。

Q：工作流运行缓慢？

  • 检查本地网络到 api.jiekou.ai 的连通性
  • 考虑使用 GPT-4o-mini or claude-3-haiku 等轻量模型
  • 对于不需要强推理的场景，轻量模型速度更快且成本更低

Q：如何批量处理大量文档？

Dify 的批处理 API 支持异步执行，配合 jiekou.ai 的稳定接口，可以高效处理大批量文档。

费用参考

以日常 Dify 开发使用为例：

场景单次消耗月均费用估算
简单问答~500 tokens~5元
文档摘要~2000 tokens~20元
复杂工作流~5000 tokens~50元

jiekou.ai 按量计费，不使用不扣费，非常适合开发测试阶段。

Summary

通过本教程，你已经掌握了如何将 Dify 与 jiekou.ai API 中转服务结合，实现：

  1. ✅ 国内直连使用 Claude 3.7 Sonnet 和 GPT-4o
  2. ✅ 构建可视化 AI 工作流
  3. ✅ 搭建企业级 RAG 知识库问答系统
  4. ✅ 按量计费，成本可控

Dify + jiekou.ai 是目前国内构建 AI 应用的最佳组合方案之一。立即访问 jiekou.ai 注册，开始构建你的第一个 AI 工作流！

Share:
Contact Us