在 FastGPT 中使用

FastGPT 接入土土金 API 需要兩步：先告訴 FastGPT 請求發到哪裡、用哪個 Key（請求地址 https://www.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://www.tutujin.com/v1
      - CHAT_API_KEY=sk-你的Key

改完重新啟動 FastGPT，再到模型配置裡啟用要用的模型，模型 ID 與模型廣場裡的名稱一致。

知識庫要用的向量模型

FastGPT 的知識庫需要向量模型。在模型配置裡新增或啟用一個索引（Embedding）類型的模型，例如 text-embedding-3-small，它和對話模型走同一個渠道。知識庫建好後不要隨意更換向量模型，否則需要重新向量化全部資料。

測試與計費

在應用裡發一條訊息，能正常回復就說明配置成功。每次呼叫都會記錄在土土金控制台的「操作日誌」裡，按 Key 所在分組的價格計費。建議給 FastGPT 單獨建一把 Key 並設定額度上限。

常見問題