快速開始 | 土土金 API 文件

土土金 API 相容 OpenAI 介面。已經在用 OpenAI SDK 的程式碼只需要改兩處：base_url 改成 https://www.tutujin.com/v1，api_key 換成你在控制台建立的 Key。整個過程大約 5 分鐘。

第 1 步：註冊帳號並充值

開啟註冊頁建立帳號，登入後進入控制台。
在控制台充值。餘額以人民幣計，按實際用量扣費，沒有月費和最低消費。
企業採購或需要開發票，可以加客服微信 JsnonoChat。

第 2 步：建立 API Key

在控制台的 API Key 頁面新建一把 Key。每把 Key 可以單獨設定：

設定項	作用
名稱	區分專案或環境，例如「客服機器人-生產」
分組	決定這把 Key 走哪條線路、按哪檔價格計費，見選擇分組
額度上限	這把 Key 最多能花多少錢，用完自動停用
過期時間	到期後自動失效，適合臨時或外包專案
模型白名單	只允許呼叫指定模型
IP 白名單	只允許指定的伺服器 IP 呼叫

Key 以 sk- 開頭。建議一個專案、一個環境各用一把 Key，出問題時可以單獨停用，不影響其他業務。

不要把 Key 寫進網頁、App 或小程式的前端程式碼，任何人開啟開發者工具都能看到它。Key 只放在你自己的伺服器上，通過環境變數讀取。更多做法見 API Key 安全最佳實踐。

第 3 步：配置 Key 和 Base URL

先把 Key 寫進環境變數，後面的示例都從環境變數讀取：

cURL

export TUTUJIN_API_KEY="sk-你的Key"

不同的介面格式使用不同的 Base URL：

你在用的 SDK 或介面	Base URL
OpenAI 相容介面（Chat Completions、Responses、Embeddings、影像、語音等）	`https://www.tutujin.com/v1`
Anthropic 官方 SDK（Claude 原生 Messages）	`https://www.tutujin.com`
Google Gen AI SDK（Gemini 原生 generateContent）	`https://www.tutujin.com`

Anthropic 和 Google 的 SDK 會自己在後面拼上 /v1/messages、/v1beta/models/...，所以這兩種只填站點根地址。

第 4 步：發出第一個請求

model 填模型廣場裡的模型名。下面用 gpt-5.4-mini 舉例：

curl https://www.tutujin.com/v1/chat/completions \
  -H "Authorization: Bearer $TUTUJIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4-mini",
    "messages": [
      {"role": "user", "content": "用一句话介绍你自己"}
    ]
  }'

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://www.tutujin.com/v1",
    api_key=os.environ["TUTUJIN_API_KEY"],
)

resp = client.chat.completions.create(
    model="gpt-5.4-mini",
    messages=[{"role": "user", "content": "用一句话介绍你自己"}],
)
print(resp.choices[0].message.content)

import OpenAI from 'openai'

const client = new OpenAI({
  baseURL: 'https://www.tutujin.com/v1',
  apiKey: process.env.TUTUJIN_API_KEY,
})

const resp = await client.chat.completions.create({
  model: 'gpt-5.4-mini',
  messages: [{ role: 'user', content: '用一句话介绍你自己' }],
})
console.log(resp.choices[0].message.content)

返回結果和 OpenAI 的格式一致，回答在 choices[0].message.content，本次用量在 usage 裡：

JSON

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "model": "gpt-5.4-mini",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "……" },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 14, "completion_tokens": 32, "total_tokens": 46 }
}

如果返回 401，說明 Key 填錯了或已經失效；返回 403 多半是餘額不足或 Key 的白名單不允許。完整對照見錯誤碼與重試。

第 5 步：核對用量和扣費

每次呼叫都會在控制台「操作日誌」裡留下一條記錄，包含模型、分組、輸入和輸出 tokens、費用。按 token 計費的模型，費用 = 輸入 tokens × 輸入單價 + 輸出 tokens × 輸出單價。以這個示例模型為例，它當前最低價分組的價格是：

模型	廠商	最低價分組	輸入 ¥/百萬	輸出 ¥/百萬	按次 ¥/次
gpt-5.4-mini	OpenAI	標準	¥1.5	¥9	—

價格為人民幣，取各模型最低價分組；價格更新於 2026年11月13日下午6:03。

計費規則的細節見計費與用量。

下一步

認證與 Base URL：三種請求頭寫法，以及各家原生 SDK 怎麼配置。
選擇分組：同一個模型在不同分組的價格和線路來源不同。
API 參考：每個介面的參數和示例。
OpenAI SDK 整合：Python 與 Node.js 的完整配置，包括流式輸出和超時重試。
從官方 API 或其他 OpenAI 相容服務遷移：已有專案遷移時的核對清單、分批切換和回滾。

沒找到答案？加客服微信 JsnonoChat，傳送報錯資訊裡的 request id，我們幫你排查。