计费与 Plans

计费信息在控制台的 Usage 和 Billing 区域查看。核心目标是按产品工作负载、Workspace、Provider 账号、Model Group 和 API key 理解费用。

Plans

ModelPlane 当前有两种面向用户的 plan 状态：

Plan	适用场景	包含 credits	Workspace 行为
Free	试用 Gateway，运行一个个人 Workspace	仅 signup credits	个人 Default Workspace 保持可用；不能创建额外个人 Workspace。
Startup	生产使用、更多 API keys、多个个人 Workspace	每月付费 credits	可以创建额外个人 Workspace；Organization Workspace 也要求付费 Startup subscription。

Organization 没有 Free plan。创建 Organization 会先进入付费 checkout，首笔付款成功后 Organization 才会变为 active。

Billing Account 与 Credits

Credits 属于 billing account，不属于单个 Workspace。

• 个人 Workspace 消耗个人 billing account 的 credits。
• 同一个 Organization 下的所有 Workspace 共享 Organization billing account 的 credits。
• Usage 仍然会按 Workspace、API key、Model Group、Backend 和 Model 归因，便于定位费用来源。
• 推理调用只会因为 billing account credits 不足或 API key 本身不可用而被拒绝。

Auto Top-Up

Startup plan 使用 auto top-up，避免生产流量因为余额过低而意外中断。

• 付费 plan 必须开启 auto top-up。
• 你可以调整触发阈值和充值金额。
• 付费 plan active 时不能关闭 auto top-up。
• 手动 top-up 会把 credits 加到所选个人或 Organization billing account。

个人账号降级到 Free

即使你已经创建了多个个人 Workspace，也可以把个人付费账号降级到 Free。

降级发生时：

• Stripe subscription 会立即取消。
• 个人 Default Workspace 会继续按 Free entitlement 使用。
• 额外个人 Workspace 会被 suspended，而不是删除。
• suspended Workspace 会保留数据，但不能修改 Backends、Model Groups、API keys 或 Workspace 设置等配置。
• 只要个人 billing account 仍有 credits，现有 active API key 仍然可以继续推理调用。
• credits 耗尽后，推理会返回 insufficient credits 错误。

如果之后重新订阅，只有因为 owner plan inactive 而被冻结的 Workspace 会恢复。你自己 archive 的 Workspace 不会自动恢复。

扣款失败

个人账号和 Organization 的扣款失败处理不同。

个人付费账号：

• 账号回落到 Free。
• Default Workspace 保持可用。
• 额外个人 Workspace 被 suspended。
• 只要 credits 仍然可用，现有 active key 仍然可以继续推理调用。

Organization：

• ModelPlane 会先尝试用 Organization 现有 credits 垫付失败的 subscription invoice。
• 如果 credits 足够，Organization 保持 active，并把该 invoice 标记为已结清。
• 如果 credits 不足，Organization 会进入 suspended，旗下 active Workspace 也会被 suspended。
• suspended Organization 仍然可以访问 billing recovery、payment method 和 billing portal。
• 只要 Organization credits 仍然可用，现有 active API key 仍然可以继续推理调用；admin/config 修改会被阻止，直到 billing 恢复。

Organization 取消与关闭

Organization 不能降级到 Free。关闭 Organization 会取消 Stripe subscription，并把 Organization 标记为 closed。历史数据会保留；billing cancellation 不会自动删除 Workspace 资源。

可以追踪什么

• 请求量。
• 输入、输出和总 tokens。
• 花费和 credits 消耗。
• 错误率和延迟。
• 按 API key、model group、backend 或 model 查看用量。
• 支持时查看 Coding Plan quota 和 reset window。

如何阅读用量

使用 model-group 视图理解产品成本。使用 backend 视图发现 Provider 账号压力、余额不足、限流或 plan 耗尽。使用 API-key 视图把流量归因到应用、环境或客户。

Plans 与 Credits

ModelPlane 可以同时展示 gateway-level credits 和 provider-level plan / balance 信息。按量计费 backend 会在支持时显示余额；Coding Plan backend 会在支持时显示 quota window 和 reset 时间。

运营建议

• 为每个生产 model group 设置预算预期。
• 大量 coding-agent 使用后检查 Coding Plan quota。
• 在错误扩散到产品前，先关注 backend-level errors。
• 对任何 quota 有限的 Provider 账号配置 fallback routing。
• 对 Organization，重点监控共享 credits，因为所有 Organization Workspace 都从同一个余额扣费。
• 付费账号保持有效 payment method，避免 Workspace 进入 suspended billing recovery 状态。