Appearance
按量付费（Pay As You Go）
- 计费模式：预充值 + 按实际消耗实时扣费，用多少付多少
- 调用端点：
https://limapi.com/api/v1（OpenAI 兼容）、https://limapi.com/api/anthropic（Anthropic 兼容） - 认证方式：
Authorization: Bearer sk-ai-v1-xxx，密钥以sk-ai-v1-开头
生产环境可直接使用
按量付费没有使用场景限制，已上线的商业产品、面向终端用户的服务、Agent 业务系统都可以直接使用：默认不限每分钟请求数，失败任务自动退款，账单逐笔可查可导出。
什么是按量付费
按量付费是 LimAPI 目前的主要计费方式。你先给账户充值，之后每次调用按该次请求的真实 token 用量与模型单价扣费，不预付固定月费、不承诺额度、也没有使用场景限制。
| 特性 | 说明 |
|---|---|
| 默认不限速率 | API Key 默认不设 RPM 上限，支持高并发调用 |
| 精准计费 | 按 token 级用量计费，输入与输出分别计价，账单逐笔可查 |
| 失败退款 | 视频等异步任务生成失败时自动退款，不占用余额 |
| 多级折扣 | 模型折扣自动匹配，账单中直接体现折后金额 |
| 完整可观测 | 调用流水、用量分析、成本分析、按 Key 归因，支持导出 |
计费口径
- 单价单位：元 / 百万 token，输入与输出分别计价，各模型单价见模型详情页。
- 阶梯计费：部分模型按输入长度分段定价（例如同一个模型在输入超过某个 token 数后单价上浮），调用前请查看模型详情页的分段说明。
- 缓存 token：命中缓存的输入 token 按低于原价的折扣价计费；显式缓存写入按高于输入价的倍率计费。各模型倍率不同，以模型详情页标注为准。
- 工具调用费：使用模型服务端工具（返回
usage中的x_tools）时，按调用次数额外计费。 - 计费以返回的
usage为准：账单里的 token 数与费用来自上游实际返回的用量，不是请求参数的估算值。
余额扣到 0 以下
发起调用前只做「余额大于 0」的预检，实际扣费按该次调用的真实用量结算，因此最后一笔调用可能把余额扣到 0 以下。此时充值即可恢复调用，欠款不会被免除，但也不会产生额外费用。
充值
- 登录 Portal 控制台，进入「充值」页面。
- 输入充值金额：单笔最低 ¥1，最高 ¥10,000。
- 使用微信支付完成付款（PC 端扫码、移动端唤起小程序），支付成功后余额实时到账。
- 在「我的订单」中查看充值记录，支持按状态筛选与分页。
订单规则
- 支付方式目前仅支持微信支付，暂不支持支付宝、Stripe 或对公转账。
- 创建后未支付的订单（
PENDING）超过 30 分钟自动关闭；如已付款但订单被关闭，款项仍会入账。 - 组织场景由 OWNER 或 ADMIN 充值到组织资金池，再分配额度给成员，详见组织用户使用指南。
API Key
按量付费的 API Key 以 sk-ai-v1- 开头，一个账户可以创建多个 Key 用于区分项目或环境。
你可以在 Portal 自助完成的操作：
| 操作 | 说明 |
|---|---|
| 创建 Key | 在「API Keys」页点击「创建密钥」并命名；完整密钥仅展示一次，请立即复制保存 |
| 暂停 / 启用 | 暂停后该 Key 的所有请求立即被拒绝，可随时恢复 |
| 重置密钥 | 生成新的密钥串，旧密钥立即失效（用于泄露后止损） |
| 删除 | 永久删除该 Key |
| 查看用量 | 每个 Key 的调用量与消耗可在「API Keys」页与用量分析中查看 |
需要联系平台支持配置的能力（Portal 暂不开放自助编辑）：
| 能力 | 说明 |
|---|---|
| 单 Key 速率上限（RPM） | 默认不限；可为指定 Key 设置每分钟请求数上限 |
| 单 Key 额度上限 | 达到上限后该 Key 返回 402 key_credit_exhausted，适合按项目做预算封顶 |
| 额度阈值提醒 | 消耗达到上限的某个百分比时，响应头带 X-Credit-Warning |
| 模型白名单 | 限制该 Key 只能调用指定模型 |
安全提示
- 不要把 API Key 提交到公开仓库或写进前端页面代码。
- 一旦泄露，立即在 Portal「重置密钥」，旧密钥会马上失效。
- Key 名称建议使用可识别的描述（如
prod-backend、staging），便于成本归因。
速率与并发
| 限制项 | 默认值 | 说明 |
|---|---|---|
| 每分钟请求数（RPM） | 不限 | Key 未配置 RPM 上限时不做限制；超限返回 429 rate_limit |
| 请求体大小 | ≤ 32 MB | 超出返回 413 request_body_too_large；含内联图片、长上下文的请求请注意体积 |
| 超大请求并发 | 单租户 16 / 全局 24 | 仅请求体 > 8 MB 的调用占用该并发额度；超限返回 429，属内存保护措施，稍后重试即可。需要更高并发请联系平台支持 |
响应头
每个通过鉴权的请求都会返回 X-RateLimit-Limit 与 X-RateLimit-Remaining（当前 Key 的 RPM 上限与剩余量），可据此做客户端限速。
余额与错误码
| HTTP 状态码 | error.type | 含义与处理 |
|---|---|---|
| 402 | insufficient_balance | 账户余额不足，充值后重试 |
| 402 | key_credit_exhausted | 该 Key 的额度上限已用尽（账户余额可能仍充足），联系平台支持调整上限或换用其他 Key |
| 403 | access_denied | 未提供 API Key，或 Key 无效 / 已暂停 / 已删除 |
| 413 | request_body_too_large | 请求体超过 32 MB |
| 429 | rate_limit | 超过该 Key 的 RPM 上限，或超大请求并发额度已满（响应带 Retry-After: 5，可退避重试） |
| 502 | no_provider_available | 该模型当前没有可用渠道，稍后重试 |
注意错误体里 error.code 是状态码字符串（如 "402"），error.type 才是语义名。完整清单与排查建议见错误码参考。
低余额提醒
在 Portal「设置 → 通知配置」中可自助开启余额提醒：
- 支持设置多档阈值（默认 ¥100 / ¥50 / ¥10）。
- 通知渠道为群机器人 Webhook（企业微信 / 飞书 / 钉钉），不是邮件；填入机器人地址即可。
- 触发后由网关推送，无需轮询接口。
此外网关还提供跑道预警：按当前消耗速率推算余额即将耗尽时提前告警，避免在业务高峰期突然返回 402。
用量与账单
| 页面 | 能看到什么 |
|---|---|
| 充值 | 余额、充值记录、订单状态 |
| 调用流水 | 逐笔调用记录（模型、token 用量、费用、状态、上游请求 ID），支持按时间与租户筛选、游标分页、查看单笔详情 |
| 用量分析 | 时间序列趋势、模型维度统计、排行榜 |
| 成本分析 | 费用构成与省钱统计 |
| API Keys | 每个 Key 的调用量与消耗 |
- 导出：用量明细可导出为
.xlsx，单次导出上限 20,000 行。 - 程序化查询：账单与用量也可以通过管理与平台 API 拉取，便于接入自己的成本看板。
按量付费 vs 订阅制套餐
| 对比维度 | 按量付费 | 订阅制套餐（即将上线） |
|---|---|---|
| 计费方式 | 预充值 + 按实际消耗扣费 | 固定月费 + 周期额度点 |
| 适用场景 | 生产环境、商业化产品、Agent 业务系统 | 个人开发、学习探索、Vibe Coding |
| 速率限制 | 默认不限 RPM | 有 RPM 与滚动窗口限制 |
| 并发限制 | 仅超大请求有并发保护 | 同上，且窗口额度用满后回落按量 |
| 成本可预测性 | 随用量波动 | 固定月费，超出部分才按量 |
| 模型范围 | 全部模型 | 文本与多模态理解模型（拟定，生成类模型除外） |
两者可以同时使用：Key 相互独立，套餐额度用尽后自动回落到按量付费继续调用。
常见问题
余额不足会发生什么？
发起调用时返回 402 insufficient_balance，请求不会被转发到上游、不产生任何费用。充值后立即可用。建议开启低余额提醒避免业务中断。
支持哪些支付方式？
目前仅支持微信支付（PC 扫码 / 小程序），单笔 ¥1 ~ ¥10,000。
调用失败会扣费吗？
计费以返回的 usage 为准；视频等异步任务在生成失败时自动退款，Seedance 类任务在成功产出后才计费。
一个账户可以创建多少个 API Key？
没有数量限制。建议按项目 / 环境分别创建，便于成本归因；不再使用的 Key 请及时暂停或删除。
怎么查某个 Key 的消耗？
Portal「API Keys」页可看每个 Key 的用量；「调用流水」页可按 Key 与时间筛选逐笔记录，也可通过管理与平台 API 程序化拉取。
需要发票或对公结算怎么办？
当前 Portal 未提供自助开票，请联系平台支持处理。