API 參考 | 土土金 API 文件

所有介面共用一個域名 https://www.tutujin.com 和同一把 Key。OpenAI 格式的介面都在 https://www.tutujin.com/v1 下面，請求體和響應體與官方 API 保持一致，所以官方 SDK 只要改 base URL 就能直接用。

介面一覽

介面	方法與路徑	狀態	模型數
Chat Completions	POST/v1/chat/completions	已實測	681
Responses	POST/v1/responses	原樣轉發	5
Claude Messages	POST/v1/messages	已實測	49
Gemini generateContent	POST/v1beta/models/{model}:generateContent	已實測	63
影像生成	POST/v1/images/generations	原樣轉發	54
影像編輯	POST/v1/images/edits	原樣轉發	31
Embeddings 向量	POST/v1/embeddings	已實測	18
Rerank 重排序	POST/v1/rerank	原樣轉發	6
語音合成 TTS	POST/v1/audio/speech	原樣轉發	8
語音識別 STT	POST/v1/audio/transcriptions	原樣轉發	1
Midjourney 繪圖	POST/mj/submit/imagine	原樣轉發	13
Suno 音樂	POST/suno/submit/music	原樣轉發	2

「已實測」表示我們在本站完成過真實呼叫與扣費核對；「原樣轉發」表示請求按原格式轉發給模型服務，參數以對應模型的官方說明為準。模型數為當前目錄中支援該介面的模型數量。

表裡的「已實測」是我們在本站做過真實呼叫、核對過扣費的介面。「原樣轉發」的介面同樣可以呼叫，請求會按原格式交給模型服務處理，參數是否生效以對應模型的官方說明為準。

專案	約定
認證	`Authorization: Bearer sk-...`；Claude Messages 也可以用 `x-api-key`，Gemini 也可以用 `x-goog-api-key`，見認證與 Base URL
請求格式	JSON（`Content-Type: application/json`）；影像編輯、語音識別上傳檔案時用 `multipart/form-data`
模型名	填模型廣場裡顯示的模型名，例如 `gpt-5.4-mini`
分組	由 Key 決定，請求裡不需要傳；同一個模型在不同分組價格不同，見選擇分組
計費	每次請求按 Key 所在分組的價格扣費，記錄在控制台「操作日誌」，見計費與用量
錯誤	返回 HTTP 錯誤狀態碼和 `error` 物件，見錯誤碼與重試

你的情況	建議
新專案，或者想在多家模型之間切換	Chat Completions：一套程式碼呼叫 GPT、Claude、Gemini、DeepSeek 等目錄裡標註支援該介面的模型
已經用 Anthropic SDK 寫好了程式碼	Claude Messages：改 base URL 即可，原生參數原樣保留
已經用 Google Gen AI SDK 寫好了程式碼	Gemini generateContent
用到只支援 Responses 格式的模型	Responses
做知識庫檢索	Embeddings 生成向量，Rerank 給檢索結果重新排序
生成或修改圖片	影像生成、影像編輯
語音播報或轉寫	語音合成 TTS、語音識別 STT
Midjourney 繪圖或 AI 音樂	Midjourney、Suno 音樂：非同步任務，先提交、再輪詢結果

想知道某個模型支援哪些介面，開啟它在模型廣場的詳情頁即可。帳戶裡能用哪些模型，也可以呼叫模型列表介面查詢。

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