计费与用量

土土金 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，发送订单号申请。国内发票可以进一步详谈。