計費規則

Lazu 採用預付費和按 token 計費。部分圖片、音訊或搜尋能力按呼叫或 provider billing unit 計費。你先儲值餘額，每次 API 呼叫按模型和 lane 的價格扣費，控制台即時展示用量。

基本公式

final_charge_microUSD =
    input_tokens * input_price_per_mtok
  + output_tokens * output_price_per_mtok
  + cache_read_tokens * cache_read_price_per_mtok
  + cache_write_5m_tokens * cache_write_5m_price_per_mtok
  + cache_write_1h_tokens * cache_write_1h_price_per_mtok
  + audio_tokens * audio_price_per_mtok
  + image_input_tokens * image_input_price_per_mtok
  + per_call_charge

內部金額使用 microUSD（1 USD = 1,000,000 microUSD），避免小數精度問題。控制台展示為 USD。

退款規則

上游結果	你支付什麼
`2xx` 成功	按上游返回的 usage 計費
stream 中斷，但最終 trailer 有 usage	按已生成並上報的 token 計費
stream 中斷且沒有 usage trailer	退款，支付 0
`5xx`、timeout、網路錯誤	退款，支付 0
`4xx`、內容政策、bad request	退款，支付 0
少數按呼叫計費的圖片或音訊模型上游中途失敗	可能按完整 per-call 計費

Usage 和 cache 欄位

OpenAI 相容回應會保留標準 usage，並在 provider 上報時附加 cache 欄位：

{
  "usage": {
    "prompt_tokens": 1200,
    "completion_tokens": 300,
    "total_tokens": 1500,
    "prompt_tokens_details": {
      "cached_tokens": 300,
      "cache_write_tokens": 100,
      "cache_write_5m_tokens": 100,
      "cache_miss_tokens": 800
    }
  }
}

完整對帳請呼叫：

curl https://api.lazu.ai/api/usage/requests/req_lazu_01ABCDEF \
  -H "Authorization: Bearer $LAZU_API_KEY"

請求詳情會返回標準化的 usage.dimensions、billing.line_items、 provider_usage.raw_fields 和 routing metadata。

Search 計費

POST /v1/search 會記錄選中 search backend 對應的 web_search line item。實際費用取決於 backend 設定的 search_price，或管理員啟用的 provider-cost passthrough。目前託管版 Tavily、Serper 和 Jina 沒有明確設定 search_price，所以 search line item 為 $0，但 usage 仍會記錄。響應會包含 web_search_requests 和 web_search_billable_units。Tavily basic 為 1 unit， advanced 為 2 units；Serper 和 Jina 通常每次成功 query 為 1 unit。

儲值和免費額度

透過控制台使用 Stripe 儲值。儲值成功後餘額立即可用。試用額度可用於測試，但不等於完成帳號驗證；要解除未驗證帳號的低頻率限制，需要完成一次真實儲值。

基本公式

退款規則

Usage 和 cache 欄位

Search 計費

儲值和免費額度

相關頁面