計費與用量

土土金 API 按實際用量扣費：餘額以人民幣計，沒有月費和最低消費。大多數模型按 tokens 計價，輸入和輸出分開算；影像生成等部分模型按請求次數計價。每次請求的模型、分組、tokens 和費用都會記在控制台的「操作日誌」裡。

兩種計費方式

一個模型按哪種方式計費、單價多少，以模型與價格裡的即時價目表為準。同一個模型在不同分組價格不同，見選擇分組。

按 token 計費的細則

單次請求的費用：

费用 = 未命中缓存的输入 tokens ÷ 1,000,000 × 输入单价
     + 命中缓存的输入 tokens ÷ 1,000,000 × 缓存读取单价
     + 输出 tokens ÷ 1,000,000 × 输出单价

舉個例子，一個客服機器人每次請求帶 2,000 tokens 的提示詞和歷史，回答 400 tokens，每月 5 萬次：

如果系統提示詞固定、模型支援上下文快取，大部分輸入可以按快取價計費。同樣的請求量，假設 2,000 tokens 輸入裡有 1,500 tokens 命中快取：

快取命中的條件由各家模型決定，實際命中多少看響應裡的 usage，原理見上下文快取是什麼、怎麼省錢。

按次計費

按次計費的模型，每次請求扣固定金額，和提示詞長短無關。比如用按次計費的繪圖模型生成 1,000 張圖片：

影像、語音類模型並不都按次計費，也有按輸入、輸出 tokens 計價的，以價目表為準；每次具體扣了多少，在操作日誌裡可以逐條核對。

在哪裡看用量

• 響應裡的 usage 欄位：Chat Completions 返回 prompt_tokens、completion_tokens，命中快取時還有 prompt_tokens_details.cached_tokens；Claude Messages 返回 input_tokens、output_tokens 和快取相關欄位。
• 控制台「操作日誌」：逐條列出每次請求的時間、Key、模型、分組、tokens 和費用，可以按條件篩選並匯出 CSV 對帳。

請求報錯時是否產生費用，以操作日誌裡的記錄為準。按專案拆帳、每月對帳的完整步驟，見成本分攤與對帳。

餘額與額度

• 餘額屬於帳戶，所有 Key 共用。餘額不足時請求返回 403，錯誤碼 insufficient_user_quota。
• 每把 Key 可以設額度上限，花完後這把 Key 返回 401，其他 Key 不受影響。用它給每個專案或外包方單獨封頂。
• 扣費按請求發生時的價格計算。

發票

國內發票和海外 Invoice 都可以開：加客服微信 JsnonoChat，傳送訂單號即可申請。