跳到正文
土土金API

集成指南

在 Dify 中使用

在 Dify 的模型供应商里添加 OpenAI-API-compatible 模型，填入土土金 API Key、API endpoint URL https://www.tutujin.com/v1 和模型名，就能在应用编排和知识库里使用 GPT、Claude、DeepSeek 等模型。

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

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

第 1 步：安装 OpenAI-API-compatible

  1. 进入 Dify 的「设置」→「模型供应商」。
  2. 如果列表里没有「OpenAI-API-compatible」，到插件市场搜索并安装它。Dify 1.0 之后，模型供应商以插件形式提供。

第 2 步：添加对话模型

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

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

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

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

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

字段填写
模型类型Text Embedding
模型名称例如 text-embedding-3-small
API Key土土金 API Key
API endpoint URLhttps://www.tutujin.com/v1

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

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

只用 GPT 模型时

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

测试与计费

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

常见问题

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

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