01
先确认身份
必须使用登录会话或带 scope 的 API key。Provider 密钥只留在服务端，不会进入浏览器。
使用场景 · 按量对话
把计量表放在眼前的对话演示
一次有边界的提问会经过模板自带的同一条链路：身份、预算准入、积分预占、provider 调用、结算与用量记录。如果这个部署没有 provider，页面会直接说明，不会伪造回复。
演示按量计费受限
尚未配置 AI provider
端点需要 OpenAI 兼容的 base URL、密钥和模型。配置完成前不会调用模型，也不会编造回复。
AI_BASE_URLAI_API_KEYAI_MODEL
还没有回复
这里只展示已配置 provider 返回的文本，不会生成占位答案。
一次请求能证明什么
范围刻意保持很窄：一次有边界的对话补全，不是图片或视频工作台。
02
先过预算再做调用
每用户日/月积分、请求数与分钟速率、并发租约在扣费前由同一条 D1 语句原子准入。
03
结算留下账本
先预占积分，再调用 provider，最后由账本记录结果。确定性拒绝会退款；未知结果保留用于对账。
它不做什么
演示把模板的边界直接摆在页面上。
- 不包含图片、视频、语音或训练工作台。这些需要单独的 provider、界面与成本控制。
- 积分是内部单位。页面不会把它换算成美元，也不会假装知道 provider 的合同价格。
- 缺少 provider 是配置状态，不是模型回答。表单会被禁用，不显示占位文本。
演示常见问题
只有当部署配置了可用的 OpenAI 兼容 provider、启用了积分，并且你已经登录时才会调用模型。否则表单禁用，页面会说明缺少哪项配置，绝不展示伪造的模型回复。