TokenLab

核心指南

帳單與定價

費用、預估、餘額與限制的運作方式

TokenLab 的餘額適用於所有模型。沒有訂閱費用或最低消費要求。儲值金額最低為 $5 美元。費用根據每個請求所記錄的模型與使用量計算。

交付選項

同一個模型與 API 可透過兩種路徑提供:Verified(驗證版)成本較低,Official(官方版)則更為可靠。交付選項決定了請求執行的路徑以及您支付的價格。

選項路徑價格若路徑無法使用時
Verified僅限 Verified:由 TokenLab 測試過的路徑Verified 價格,大多數模型上低於 Official 價格請求失敗且不收費
Official僅限 Official:模型製造商或主要平台Official 價格,模型製造商公佈的價格請求失敗且不收費
Auto (預設)優先使用 Verified。若 Verified 無供應或在輸出前失敗,則由 Official 執行一次請求完成請求的路徑價格由 Official 執行請求

「模型」(Models) 頁面會顯示每個模型的兩種價格。

  • 每個完成的請求僅收費一次。
  • Auto 不會在輸出開始後或任務被接受後進行切換。
  • 在執行前,Auto 會預扣兩種可能金額中較高者。如果餘額僅足夠支付 Verified 的預估費用,Auto 將僅針對該請求執行 Verified,而不會回退至 Official。執行完成後,您將支付實際費用,剩餘金額會被釋放。
  • X-TokenLab-Delivery-Policy 請求標頭會覆蓋 API 金鑰設定,而 API 金鑰設定會覆蓋工作區 (Workspace) 的預設值。請參閱 API 簡介。

對於付費生成,Console 會在確認前顯示最高預估費用。完成後,「執行紀錄」(Runs) 與「使用量」(Usage) 會顯示最終費用以及完成請求的選項。

定價模型

模型價格可能會變動。請查看 Console、模型頁面、GET /v1/models/:model/pricing 或 定價 API 以獲取當前價格。

在模型頁面上,Verified 價格或折扣欄中的橫線表示目前沒有可用的 Verified 方案;這並不代表免費。具有 Official 供應的模型仍可透過 Official 或 Auto 使用。在 API 中,此類模型的 Verified 價格欄位為 null 或被省略,而 official_* 價格欄位則顯示您需支付的費用。交付標籤描述了支援的選項,而可用性會在每個請求執行時進行檢查。系列價格總結了在相關交付選項中具有供應的模型,並將不同的計費單位分開。

基於 Token 的定價

大多數聊天、推理、嵌入 (embedding)、重排序 (rerank) 以及部分圖像模型是根據輸入、輸出、快取或圖像輸出 Token 來計費。

定價系列範例查看當前價格
聊天 / 回應gpt-5.4, claude-sonnet-4-6, gemini-3.6-flash模型頁面或定價 API
嵌入 / 重排序text-embedding-3-small, qwen3-vl-rerank模型定價詳情
Token 計費圖像gpt-image-2GET /v1/models/gpt-image-2/pricing

請勿將複製的價格表硬編碼 (hard-code) 到程式中。當您的應用程式需要顯示或比較成本時,請讀取當前價格。

工具費用

某些內建工具會在 Token 費用之外額外收費。TokenLab 僅在模型使用該工具且回應報告該使用情況時收取工具費。若請求提供了模型未使用的工具,則不會收取工具費。

工具模型收費
網路搜尋OpenAI、Claude 和 Grok 模型,以及具備 Google 搜尋基礎 (grounding) 的 Gemini 3 模型模型執行的每次搜尋。對於 Gemini 3,為每個唯一的搜尋查詢
搜尋基礎 (Search grounding)具備 Google 搜尋基礎的 Gemini 2.5 模型每次搜尋基礎化的請求收費一次
  • 每個模型針對 Verified 和 Official 都有各自的工具費,與其 Token 價格相同。模型的定價詳情會將其顯示為 Web search 或 Search grounding。
  • 模型讀取的搜尋結果將按該模型的價格作為輸入 Token 計費。
  • 模型上未標註價格的工具不會收費。
  • 在 Console 中,於「執行紀錄」(Runs) 開啟請求:工具費用 (Tool fees) 會顯示呼叫次數與每次呼叫的價格。API 金鑰使用紀錄會在 charged_price_basis 中顯示相同數值:measure.dimensions.webSearchCalls 或 groundedPrompts 中的計數,以及 effectiveUnitPrices.webSearch 或 effectiveUnitPrices.groundedPrompt 中每次呼叫的價格。

Prompt 快取

模型可以從快取中讀取重複的 Prompt 開頭。從快取讀取的 Token 成本低於輸入 Token。

  • GPT、Gemini 和其他一些模型會自動快取長且重複的 Prompt。您無需進行任何設定。
  • Claude 模型僅在您要求時才會快取。在 聊天完成 請求中傳送 "anthropic_options": {"prompt_caching": true}。TokenLab 會將系統 Prompt 的結尾和最新的使用者訊息標記為快取點。使用 Messages API 時,請自行將 cache_control 加入區塊中。
收費與輸入價格相比
快取寫入,5 分鐘(預設)較高
快取寫入,1 小時 ("prompt_caching_ttl": "1h")高於 5 分鐘寫入
快取讀取較低
  • 快取價格因模型和交付選項而異。在依賴比例計算前,請先在模型頁面或 定價 API 查看該模型的快取價格。
  • 由於快取寫入的緣故,從不重複的 Prompt 在開啟快取時成本會稍微增加。
  • 短於模型最小可快取長度的 Prompt 不會被快取,也不會有快取寫入費用。
  • 並非所有模型都提供一小時快取。如果模型未列出該選項,請使用五分鐘快取。
  • 回應會顯示結果:usage.prompt_tokens_details.cached_tokens 是從快取讀取的 Token 數量。usage.cache_creation_input_tokens 是寫入快取的數量,僅在數值大於零時出現。

服務層級

TokenLab 在標準服務層級執行請求並進行計費。接受 service_tier 值為 auto 和 default。其他值(如 flex、priority、fast 和 ultrafast)將被忽略:請求將以標準層級執行並按標準價格收費。

請求與任務定價

圖像、影片、音樂、3D、音訊和世界模型可能按請求、圖像、秒、分鐘或任務計費。模型頁面會顯示計費單位。

系列範例
圖像flux-pro-1.1
影片veo3.1, seedance-2.0
音樂suno-music
3Dtripo-h3.1
音訊grok-tts, whisper-large-v3

非同步任務計費

某些任務在建立時會預留預估成本。已完成的任務僅收費一次;失敗的任務會釋放或退還待處理的金額。

影片、音樂、3D 和基於任務的圖像生成會回傳任務 ID 和 poll_url。最終金額會在任務變為 completed 或 failed 後記錄。已完成的任務在計費後會包含 billing_transaction_id;失敗的任務則不收費。

如果任務完成後,「使用量」(Usage) 仍未顯示最終費用或釋放金額,請附上請求 ID 和任務 ID 並聯繫 hello@tokenlab.sh。

計費交易 ID

非串流的 OpenAI 相容回應會在計費於回應傳送前完成時包含 billing_transaction_id。相同的值可能會出現在 X-Billing-Transaction-ID 中;Gemini 和其他原生格式可能僅在此標頭中公開該值。

非同步任務在完成後會包含 billing_transaction_id。串流可能會在計費完成前結束,因此若標頭不存在,請使用「使用量」(Usage)。

Token 計數

文字模型通常會在 usage 中報告輸入、輸出和總 Token 數。Token 化方式因模型、語言和媒體輸入而異,因此字元計數公式並非可靠的計費預估方式。請使用模型的當前價格和最終的「使用量」(Usage) 紀錄。

查詢您的使用量

開啟 使用量 以查詢:

  • 即時餘額
  • 按模型分類的使用紀錄
  • 成本明細
  • API 金鑰使用量

API 回應

基於 Token 的回應通常包含使用量資訊:

{
  "usage": {
    "prompt_tokens": 50,
    "completion_tokens": 100,
    "total_tokens": 150
  }
}

節省成本

低餘額警示

在 Console → Settings 中設定閾值。當餘額低於該值時,TokenLab 會發送電子郵件通知您。

儲值餘額

開啟 Console → Billing,選擇金額,並使用結帳時顯示的付款方式之一。餘額會在付款提供者確認付款後更新。

在試用額度優惠期間,符合資格的新帳戶可獲得一次性的 $0.25 試用額度,最多可用於 10 次呼叫。未使用的試用額度將於 7 天後過期。

為防止請求因餘額不足而停止,請在 Billing 中開啟 Automatic funding(自動儲值)。當餘額低於您設定的金額時,它會自動儲值,最高可達每月限額。

API 金鑰限制

您可以在 Console → API Keys 中建立或編輯 API 金鑰時設定消費限額。

當達到限額時,使用該金鑰的請求將回傳 402 錯誤代碼 quota_exceeded。請提高或移除限額以繼續使用。

計費協助

如有計費相關疑問,請聯繫 hello@tokenlab.sh。

本頁內容