必须通过自定义API节点接入TypeSafe官方Jev服务,使用专用API Key(非OpenAI风格),基础URL为https://api.typesafe.ai/v1,调用时需手动设置Authorization头为Bearer Token,并在HTTP节点中以JSON传input、choices、task三字段,返回结果可用代码执行或变量提取节点解析。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在Dify工作流中调用Jev模型完成结构化判断(如路由、评分、布尔判定),必须绕过Dify原生模型列表的限制,通过自定义API节点接入TypeSafe官方提供的Jev服务端点。
确认Jev服务可用性与认证方式
访问 https://api.typesafe.ai/v1/jev,使用你的API Key发起一次curl测试请求。Jev不接受Bearer Token以外的身份凭证,【必须使用由TypeSafe官网发放的专用API Key,而非OpenAI风格的通用密钥】。若返回401错误,请立即前往TypeSafe控制台重新生成Key——旧Key在2026年9月18日后已全部轮换失效。
这一步不能跳过。Dify无法自动识别Jev的认证头格式,手动验证可避免后续所有节点报错都指向“连接失败”这一模糊提示。
在Dify中配置Jev为自定义模型供应商
进入Dify后台 → 设置 → 模型供应商 → 新建供应商 → 选择“自定义”类型。
填写以下字段:
名称:填“Jev-Router”或你实际用途的标识;
基础URL:https://api.typesafe.ai/v1(注意结尾无斜杠);
API密钥:粘贴上一步获取的有效Key;
模型名称:留空或填“jev”(Dify此处仅作标识,不参与实际调用)。
保存后不需测试连接——Jev接口不提供/health或/v1/models等兼容OpenAI的探针路径,Dify的“测试连接”按钮必然失败,但不影响后续使用。
构建含Jev调用的工作流
新建工作流 → 添加“HTTP请求”节点 → 方法选POST → URL填:https://api.typesafe.ai/v1/jev。
在Headers中添加:
Content-Type: application/json
Authorization: Bearer <你的API Key>
Body使用JSON格式,必须包含三个字段:
① input:字符串,传入待判断的原始文本或结构化状态描述;
② choices:数组,明确列出所有候选选项(Jev绝不生成新选项);
③ task:字符串,值为"choice"、"score"或"noul"三者之一。
例如做路由判断:
{"input": "用户问退款但订单已签收超7天", "choices": ["人工审核", "自动拒绝", "升级客服"], "task": "choice"}
【choices数组不能为空且不可动态生成,Dify变量语法{{xxx}}在此处无效】。若需根据上游结果切换选项集,必须拆成两个HTTP节点:第一个先查选项库,第二个再用静态choices字段调Jev。
解析Jev返回的结构化结果
方法一:用“代码执行”节点做JSON提取
在HTTP节点后接“代码执行”,输入参数设为HTTP节点的响应体(response_body)。代码内直接解析response_body['choice']或response_body['score']字段,无需额外容错——Jev保证输出必含且仅含一个主结果字段。
方法二:用Dify内置“变量提取”节点
添加“变量提取”节点 → 来源选上一个HTTP节点 → JSON路径填$.choice(或$.score、$.noul)→ 输出变量名设为route_result。此方式无需写代码,但要求Jev返回体严格符合schema,而TypeSafe在2026年9月20日的更新中已将noul字段默认转为小写布尔值,不再包裹在对象中。
提取后的变量可直接用于条件分支、消息组装或写入数据库节点。


















