LongCat API 按量付费
LongCat API 按量付费按实际 Token 用量计费，无固定套餐门槛，无需保底承诺。
前置准备
开始使用 LongCat API 之前，需要完成以下前置工作：
- 进入 LongCat 平台，登录账号。
- 在「API Keys」页面创建并获取 API Key。
- 中国大陆用户需要完成实名认证（详见常见问题-账号认证与权益）。
- 在「费用中心 → 充值订阅」完成充值。
模型与价格
当前 API 按量付费支持模型 LongCat-2.0。
| 计费项 | 原价 / 百万 Tokens | 折扣价 / 百万 Tokens（限时） |
|---|---|---|
| 输入（未命中缓存） | ¥5 | ¥2 |
| 输入（命中缓存） | ¥0.10 | ¥0.04 |
| 输出 | ¥20 | ¥8 |
| 计费项 | 原价 / 百万 Tokens | 折扣价 / 百万 Tokens（限时） |
|---|---|---|
| 输入（未命中缓存） | $0.75 | $0.30 |
| 输入（命中缓存） | $0.015 | $0.006 |
| 输出 | $2.95 | $1.20 |
折扣价为平台初上线限时优惠，实际费用以结算为准。
费用如何计算
API 请求按照输入Token（未命中缓存）、输入Token（命中缓存）、输出 Token分别计价：
调用费用 = 输入(未命中缓存)单价 × 输入（未命中缓存）Token 数量
+ 输入(命中缓存)单价 × 输入（命中缓存）Token 数量
+ 输出单价 × 输出 Token 数量计算示例
假设一次调用满足以下条件（按折扣价计算）：
- 输入 Token：1,000,000（其中命中缓存 400,000，未命中缓存 600,000）
- 输出 Token：500,000
则本次费用为：
| 项目 | 计算方式 | 金额 |
|---|---|---|
| 输入（未命中缓存） | 600,000 ÷ 1,000,000 × ¥2 | ¥1.20 |
| 输入（命中缓存） | 400,000 ÷ 1,000,000 × ¥0.04 | ¥0.016 |
| 输出 | 500,000 ÷ 1,000,000 × ¥8 | ¥4.00 |
| 合计 | ¥1.20 + ¥0.016 + ¥4.00 | ≈ ¥5.22 |
| 项目 | 计算方式 | 金额 |
|---|---|---|
| 输入（未命中缓存） | 600,000 ÷ 1,000,000 × $0.3 | $0.18 |
| 输入（命中缓存） | 400,000 ÷ 1,000,000 × $0.006 | $0.0024 |
| 输出 | 500,000 ÷ 1,000,000 × $1.2 | $0.6 |
| 合计 | $0.18 + $0.0024 + $0.6 | = $0.7824 |
调用成功（HTTP 200）后实时扣减余额；调用失败的请求（如 HTTP 401 / 403 / 429 / 500）不计费。
充值与余额
API 按量付费采用余额预充值扣减。充值成功后，金额进入账户可用余额；调用 API 时，系统按实际 Token 消耗实时扣减余额。
充入余额长期有效、无过期时间，随用随扣。若账户同时存在赠送额度，赠送额度优先于充值余额扣减。
如何充值
- 进入 LongCat 平台，打开「费用中心 → 充值订阅」。
- 查看当前可用余额。
- 选择充值金额，或填写自定义金额。
- 点击「立即充值」，按页面提示完成支付。
支付方式
当前支持的支付方式包括：
- 支付宝
- 微信支付
支付完成后，充值金额会进入账户余额。
当前支持的支付方式包括：
- 银行卡
- Google Pay
支付完成后，充值金额会进入账户余额。
账单与扣费记录
你可以在「用量管理」页面查看 API 扣费记录和月度账单。
退款规则
未消耗的充值余额，可以申请退款。
退款条件
- 已消耗金额不支持退款。
- 最小退款金额为 ¥0.01。
- 微信、支付宝超过 12 个月的订单不支持退款。
- 一个账户同一时间只能有一笔处理中的退款申请。
- 已消耗金额不支持退款。
- 最小退款金额为 $0.01。
- 微信、支付宝超过 12 个月的订单不支持退款。
- 一个账户同一时间只能有一笔处理中的退款申请。
申请退款
- 打开「费用中心 → 退款管理」。
- 查看可退款金额，填写退款原因。
- 确认并提交退款申请。
- 在「历史退款申请」中查看处理进度。
重要：退款申请提交后无法撤销。审核期间，本账号 API 调用将暂停，也无法继续充值。审核通过后，款项会按原支付路径退回，通常 1–3 个工作日到账。
计费可能存在延迟，页面展示的可退款金额为预估金额，最终以实际到账金额为准。
退款金额与路径说明
API 按量付费的可退款金额为近 12 个月内充值金额减去已消耗金额，按充值订单逆序退款、原路退回，不支持自定义退款金额。
发票规则
LongCat API 开放平台支持对 API 按量付费的已消费金额申请电子发票，可开票金额 = 已消费金额 − 已开票金额。
发票类型（普票/专票）、申请流程及其他常见问题，请参考常见问题-发票问题。
实名认证
中国大陆用户在充值前，需要先完成实名认证。个人实名认证与企业认证的流程与规则，请参考常见问题-账号认证与权益。
欠费与服务恢复
当账户余额小于等于 ¥0 时，API 会返回余额不足相关错误，并暂停新的调用。
当账户余额小于等于 $0 时，API 会返回余额不足相关错误，并暂停新的调用。
恢复方式：
- 进入「费用中心」充值。
- 充值完成后，账户余额大于 ¥0 时，API 调用恢复。
恢复方式：
- 进入「费用中心」充值。
- 充值完成后，账户余额大于 $0 时，API 调用恢复。
常见问题
API 按量付费和 Token资源包有什么区别？
API按量付费先充值余额再按实际 Token 消耗实时扣费，适合用量不固定、想精确控制成本的场景。
Token资源包是一次性购买固定 Token 额度，购买后 30 天内有效，与按量付费余额独立计费、互不抵扣。
同时充值API按量付费和购买Token资源包的情况，模型调用将优先消耗Token资源包中的Token，再消耗API按量付费余额。
调用失败的请求会扣费吗？
不会。HTTP 401 / 403 / 429 / 500 等失败响应都不会扣减余额。只有成功返回（HTTP 200）的请求才按实际 Token 用量计费。
充值余额的有效期是？
充入余额长期有效、不过期，会一直保留直到被消耗或退款。
充值金额可以马上开票吗？
不可以。预充值但未消费的金额不计入可开票金额。只有实际消费后的金额可以开票。
退款期间还能继续调用 API 吗？
不能。退款审核期间，账户 API 调用会暂停，也无法继续充值。
余额不足时会怎样？
余额不足或余额小于等于 ¥0 时，新的 API 请求会被拒绝。充值后余额大于 ¥0 即可恢复。
余额不足或余额小于等于 $0 时，新的 API 请求会被拒绝。充值后余额大于 $0 即可恢复。
发票多久能开好？
通常 1–3 个工作日内开具。开具完成后会发送至你填写的邮箱，也可以在开票记录中下载。详见常见问题-发票问题。