在 Dify 中使用 | 土土金 API 文档

Dify 通过「OpenAI-API-compatible」模型供应商接入土土金 API：添加模型时填入土土金的 API Key、API endpoint URL https://open.tutujin.com/v1 和模型名。每个模型添加一次，之后在应用编排、工作流和知识库里都能直接选用。

下面按 Dify 1.x 的界面描述。Dify 版本更新较快，菜单名称和字段位置可能和你看到的略有不同，填写的内容是一样的。

第 1 步：安装 OpenAI-API-compatible

在 OpenAI-API-compatible 上点「添加模型」，按下表填写：

字段	填写
模型类型	LLM
模型名称	模型广场里的模型名，例如 `deepseek-v4.1-flash`
API Key	土土金 API Key
API endpoint URL	`https://open.tutujin.com/v1`
Completion mode	Chat
模型上下文长度、最大 token 上限	按所选模型官方公布的数值填写
Function calling、Vision 支持	模型本身支持时再开启

保存后，在应用的模型下拉框里就能选到这个模型。想用多个模型，就重复添加，每个模型名一条。

Dify 知识库需要一个向量模型。同样点「添加模型」：

添加后在「系统模型设置」里把它设为默认的 Embedding 模型。如果你的 Dify 版本在这个供应商下支持 Rerank 类型，也可以用同样方式添加重排模型，例如 qwen3-reranker-8b。

知识库建好之后不要随意更换向量模型。不同向量模型生成的向量不能混用，换模型需要重新向量化全部文档。

如果只用 OpenAI 的模型，也可以直接配置 Dify 自带的「OpenAI」供应商：API Key 填土土金的 Key，API Base 填 https://open.tutujin.com/v1。调用其他厂商的模型时，用 OpenAI-API-compatible 更合适。

在应用的调试面板发一条消息，能正常回复就说明配置成功。之后每次调用都会出现在土土金控制台的「用量明细」里，按 Key 所在分组的价格计费。可以给 Dify 单独建一把 Key，并设置额度上限，见认证与 Base URL。

现象	原因与处理
保存模型时校验失败	检查 API endpoint URL 是否为 `https://open.tutujin.com/v1`，模型名是否和模型广场一致
401	Key 填错或已失效
503 并提示 `model_not_found`	Key 所在分组没有这个模型，见选择分组
回答被截断	调大模型的最大 token 上限

没找到答案？加客服微信 JsnonoChat，发送报错信息里的 request id，我们帮你排查。

第 2 步：添加对话模型

在 OpenAI-API-compatible 上点「添加模型」，按下表填写：

字段	填写
模型类型	LLM
模型名称	模型广场里的模型名，例如 `deepseek-v4.1-flash`
API Key	土土金 API Key
API endpoint URL	`https://open.tutujin.com/v1`
Completion mode	Chat
模型上下文长度、最大 token 上限	按所选模型官方公布的数值填写
Function calling、Vision 支持	模型本身支持时再开启

保存后，在应用的模型下拉框里就能选到这个模型。想用多个模型，就重复添加，每个模型名一条。

第 3 步：添加向量模型（知识库用）

Dify 知识库需要一个向量模型。同样点「添加模型」：

知识库建好之后不要随意更换向量模型。不同向量模型生成的向量不能混用，换模型需要重新向量化全部文档。

常见问题

现象	原因与处理
保存模型时校验失败	检查 API endpoint URL 是否为 `https://open.tutujin.com/v1`，模型名是否和模型广场一致
401	Key 填错或已失效
503 并提示 `model_not_found`	Key 所在分组没有这个模型，见选择分组
回答被截断	调大模型的最大 token 上限