Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

计费规则

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 计费

如果 Lazu 返回 200，通常需要支付；如果 Lazu 返回 4xx、5xx 或 timeout， 通常不会扣费。

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
    }
  }
}

cached_tokens 表示 cache read；cache_write_tokens、cache_write_5m_tokens 和 cache_write_1h_tokens 表示 cache creation/write。完整对账请调用：

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 仍会记录。响应会包含：

{
  "usage": {
    "web_search_requests": 1,
    "web_search_billable_units": 1
  }
}
  • web_search_requests 是 Lazu 请求次数，通常为 1。
  • web_search_billable_units 是 provider 实际计费用量。
  • Tavily basic = 1 unit，advanced = 2 units。
  • Serper 通常每次成功 query = 1 unit。
  • Jina 通常每次成功 query = 1 unit。

充值和免费额度

通过 控制台 使用 Stripe 充值。充值成功后余额立即可用。

  • 最低充值：$5
  • 余额不过期
  • 新账号可能有试用额度，但试用额度不等于完成验证
  • 要解除未验证账号的低频率限制，需要完成一次真实充值

查看用量

  • Console -> Usage：按天、模型、API Key 查看用量。
  • Console -> Billing：发票、充值历史和当前余额。
  • API：GET /api/usage/requests/{request_id}。

不会额外叠加的东西

Lazu 不会在 lane 价格上再叠加隐藏费用：

  • 不额外收取 premium tier surcharge
  • 不按周末、地区或模型大小加价
  • 不对 cache read 或 audio token 额外加隐藏 markup

如果实际扣费和 tokens * listed_price 对不上，请带 request_id 联系支持。

相关页面