在 FastGPT 中使用

FastGPT 接入土土金 API 需要两步：先告诉 FastGPT 请求发到哪里、用哪个 Key（请求地址 https://open.tutujin.com/v1 加土土金 API Key），再在模型配置里启用要用的模型，模型 ID 和土土金模型广场里的模型名保持一致。

方式一：在管理后台添加模型渠道

适用于在页面上管理模型渠道的版本：

1. 用管理员账号登录，进入模型提供商（或模型渠道）的设置页面。
2. 新增一个渠道，协议类型选 OpenAI，按下表填写：

3. 到「模型配置」里确认这些模型已启用。列表中没有的模型，新增一个自定义模型，模型 ID 填模型名，例如 deepseek-v4.1-flash。
4. 保存后，在应用的 AI 配置里就能选到这些模型。

方式二：通过部署时的环境变量

用 docker compose 部署、且版本支持这两个环境变量时，可以在 FastGPT 服务的环境变量里指定默认的请求地址和 Key：

services:
  fastgpt:
    environment:
      - OPENAI_BASE_URL=https://open.tutujin.com/v1
      - CHAT_API_KEY=sk-你的Key

改完重新启动 FastGPT，再到模型配置里启用要用的模型，模型 ID 与模型广场里的名称一致。

知识库要用的向量模型

FastGPT 的知识库需要向量模型。在模型配置里新增或启用一个索引（Embedding）类型的模型，例如 text-embedding-3-small，它和对话模型走同一个渠道。知识库建好后不要随意更换向量模型，否则需要重新向量化全部数据。

测试与计费

在应用里发一条消息，能正常回复就说明配置成功。每次调用都会记录在土土金控制台的「用量明细」里，按 Key 所在分组的价格计费。建议给 FastGPT 单独建一把 Key 并设置额度上限。

常见问题