白板计费与配额
计费维度、免费额度、房间与成员限制、操作日志保留与限流。
白板按“房间 + 用量”计费。单价与免费额度属于部署配置，本文给出计量口径与默认值；实际账单以部署的计费配置为准。
计费维度
| 维度 | 计量方式 | 说明 |
|---|---|---|
| 房间时长 | 房间从创建到关闭的分钟数 | 关闭后不再计费，快照与回放读取不计费 |
| 写者成员 | 同时持有 writer / admin 的成员峰值 | 超出房间 limit 的加入会被拒绝 |
| 操作写入 | 笔迹、图片、视口、场景操作次数 | 撤销/重做也计为一次操作 |
| 快照导出 | JSON / SVG 导出次数 | 回放读取按操作帧计 |
| 存储 | 操作日志与快照的保留量 | 默认每房间保留最近 10000 条操作 |
免费额度
每个项目默认包含：
- 每月 60 分钟白板房间时长。
- 每月 10000 次操作写入。
- 100 次快照导出。
- 3 个并发房间。
免费额度用尽后，接口返回 429 rate_limited（请求频率）或配额类错误；不会静默降级。
限额与限制
| 项目 | 默认值 | 超出行为 |
|---|---|---|
| 房间写者上限 | 由房间 limit 决定，0 为不限 | HTTP 409，错误码 whiteboard_version_conflict |
| 单房间操作日志 | 10000 条 | 最旧记录不再进入回放 |
| 单条笔迹点数 | 4096 | 400 invalid_parameter |
| 场景名长度 | 64 字符 | HTTP 400，错误码 whiteboard_invalid_scene_path |
| 房间 Token 有效期 | 调用方指定，0 为不过期 | 过期后 401 token_expired |
| 项目请求频率 | 由平台限流配置决定 | 429 rate_limited，按 retryAfterSeconds 退避 |
账单口径
- 分钟数按 UTC 自然分钟向上取整。
- 同一房间的并发写者按峰值计，不重复计房间时长。
- 免费额度按项目、按自然月重置。
- 单价与币种由部署的计费配置提供；控制台账单页展示的是该部署的实际配置。