客户端接入 · Dify

Dify 接入 HardysAPI:用兼容供应商接全部模型

Dify 自带 OpenAI 供应商,但它只认官方模型名。要接中转站里的全部模型,用 OpenAI-API-compatible 这个供应商,每个模型单独添加一条。

先准备两样东西:在 控制台 创建 API 密钥(复制 sk- 开头的完整字符串), 以及要用的模型名(从 模型价格 里挑,名字要一字不差)。

配置步骤

  1. 右上角头像 → 设置 → 模型供应商;
  2. 找到 OpenAI-API-compatible,点「添加模型」;
  3. 模型类型 选 LLM;
  4. 模型名称 填模型名,例如 claude-sonnet-4-5;
  5. API Key 粘贴密钥,API endpoint URL 填 https://hardysapi.com/v1;
  6. 上下文长度 按模型填(不确定填 200000 不影响计费,只影响 Dify 的截断策略);
  7. 保存后在应用编排的模型下拉里即可选择。

不同模型类型怎么填

用途模型类型备注
对话 / 工作流LLM最常用,支持工具调用
文本向量化Text Embedding需分组里有 embedding 模型
重排序Rerank需分组里有 rerank 模型

常见坑

  • 工作流里报「模型不支持工具调用」:部分兼容模型不返回 tool_calls,换模型或在编排里改用「提示词 + JSON 输出」;
  • 知识库检索报 embedding 失败:embedding 与对话是两类模型,需要分别添加;
  • 每个模型都要重复填 endpoint:Dify 的设计如此,建议用同一个密钥减少出错。

常见问题

Dify 的 API endpoint URL 填什么?

https://hardysapi.com/v1。注意 Dify 会在后面拼 /chat/completions,不要再手动加路径。

Dify 能用 Claude 模型吗?

可以,通过 OpenAI-API-compatible 供应商接入,模型名填 claude-sonnet-4-5 等完整名称。