AI Credits 用户手册
AI Credits 根据账号或项目方案预约开通。它管理 MAWflow 产品中的 AI 额度、预算和受控模型调用，让项目成员在不接触供应商凭据的前提下完成一次低风险任务，并能从项目台账解释预估、实际用量和失败补偿。
当前采用人工授予额度，在线支付为 disabled。页面不会产生订单、支付成功或发票记录，也不会出售或共享第三方账号。若尚未确定任务场景和模型选择方式，请先阅读 AI 接入与使用。
开始前准备
你需要满足四项条件：
- 已登录 MAWflow，并能进入目标项目。
- 你是该项目的有效成员。
- 项目已开通 AI Credits 权益。
- 管理员已建立人工授予账户，并确认可用额度与预算边界。
项目入口为 /projects/{项目标识}/ai-credits。如果页面显示 account_required、entitlement required 或 provider not configured，按页面“风险与下一步”处理；这些状态不会展示虚假余额或假成功。
页面状态怎么读
| 状态 | 含义 | 你应该做什么 |
|---|---|---|
| available | 当前可用于新任务的额度 | 与本次估算值比较 |
| 已预留 | 已为进行中任务锁定、尚未结算的额度 | 等待完成或过期对账 |
| entitlement | 项目是否已获使用资格 | 未开通时联系管理员 |
| provider | 服务端模型服务是否就绪 | 未配置时不能签发调用授权 |
| payment | 固定显示 disabled | 额度通过人工授予获得 |
| first value | 首次受控调用走到哪一步 | 按页面顺序继续 |
模型状态与真实边界
模型目录会显示公开状态、评估状态、计价状态和限制：
candidate、pending_eval或adapting：不可估算、不可调用。limited：只确认了服务端适配契约。你必须阅读限制并显式确认；它不代表已经完成真实 MAWflow 质量评估，也不是推荐结论。- 模型适配、任务约束和资源选择理由由 MAWflow Fit 管理；AI Credits 只消费已确认的资源选择与预算信息。
页面不接收、不显示供应商凭据，也不会返回供应商原始输出。任务摘要和调用记录只保留公开安全信息。
第一次成功：四步完成一次低风险调用
第 1 步：选择模型并估算
- 在“模型目录与额度估算”选择一个可调用模型。
- 填写预计输入和输出 tokens。
- 点击“估算，不调用模型”。
- 确认结果为
accepted，并记录预计 credits。
估算只计算额度，不会调用模型，也不会改变余额。
第 2 步：预留预算
- 填写清楚的业务理由。
- 确认预留金额、任务预算、模型预算和 15 分钟有效期。
- 点击“确认预留”。
- 在预留列表看到
active和对象版本。
重复请求会返回同一结果；如果同一请求标识携带了不同内容，系统会拒绝冲突。预留只增加“已预留额度”，不会减少账户余额。
第 3 步：签发短期单次授权
- 选择一条
active预留记录。 - 如果模型状态为
limited，阅读并勾选限制确认。 - 点击“签发一次性授权”。
- 页面显示“已暂存，可调用一次”。
授权最长五分钟，绑定当前项目、模型、功能和操作者；服务端只保存校验摘要。页面不会显示授权内容，刷新后也不会恢复它。授权过期、撤销、换人使用或再次使用都会在模型调用前被拒绝。
第 4 步：调用并核对结算
- 在“公开安全任务摘要”中只写任务目的，不粘贴客户数据、源码、凭据或原始材料。
- 点击“调用一次并自动对账”。
- 成功时查看实际 credits、tokens、延迟、调用状态和账本流水。
- 在相同执行追踪标识下核对预留、实际扣减和未用额度释放。
第一次成功的通过标准是：一次低风险调用完成、授权只能使用一次、未暴露供应商凭据、实际用量不超过预留，并且账本与调用记录能按执行追踪标识互相核对。
成功、失败与补偿规则
| 场景 | 额度处理 | 页面证据 |
|---|---|---|
| 调用成功 | 按实际 tokens 扣减，释放未使用预留 | 实际 credits、扣减与释放流水 |
| 服务未配置或调用失败 | 不扣费，只释放预留 | not_billed_fallback 与失败摘要 |
| 授权过期、撤销或重放 | 模型调用前拒绝 | 授权状态与安全错误 |
| 实际用量超过预留 | 不静默透支，进入人工对账 | reconciliation_required |
| 预留超过有效期 | 管理员执行过期对账并释放 | 对账数量、释放额度与流水 |
| 已扣减后确需返还 | 必须绑定原扣减记录，累计不得超额 | 返还流水与关联记录 |
失败路径不会通过“返还”凭空增加余额。未发生扣减时只释放已预留额度；只有已存在的扣减记录才能被受控返还。
管理员操作
管理员可以在同一页面执行：
- 建立人工授予账户，并设置初始额度、月度上限、硬上限和告警阈值。
- 更新预算边界；保存时校验对象版本，避免覆盖他人的新修改。
- 进行有理由、可追踪的人工调整；普通项目成员不能执行。
- 对账并释放已过期的孤儿预留。
所有写操作以服务端可信身份为准，页面提交的操作者文本不会替代当前登录身份。
安全使用清单
- 不在公开安全任务摘要中填写客户数据、完整源码、账号、凭据或本机绝对路径。
- 不把
limited理解为真实质量评估通过或系统推荐。 - 不把 credits 理解为现金余额；当前不存在在线购买和自动扣款。
- 不重复使用、复制或记录短期授权；页面本身也不会展示它。
- 异常时先查看风险、下一步、预留状态、调用状态和执行追踪标识。
按官网步骤自测
- 打开项目 AI Credits 页面，确认开通范围、人工授予和“暂不支持在线购买”清晰可见。
- 未开通账户或权益时，确认页面不给出虚假余额或购买成功。
- 选择候选模型，确认不可估算或调用；选择
limited模型，确认签发前必须勾选限制。 - 完成一次估算，确认余额和调用次数不变。
- 完成一次预留，确认可用额度减少、已预留额度增加，账本出现预留流水。
- 在服务未配置的环境尝试签发，确认失败关闭且页面给出可恢复原因。
- 在服务已配置的测试环境签发一次授权，确认页面不显示其内容。
- 完成一次调用，确认授权变为
consumed，再次使用会被拒绝。 - 核对预留、实际扣减、未用释放、tokens、延迟和执行追踪标识。
- 模拟服务失败，确认实际成本为 0，只释放预留，余额不会增加。
- 等待预留过期后执行管理员对账，确认孤儿预留被释放且保留审计记录。
- 用普通成员尝试人工调整或对账，确认被拒绝。
下一步阅读
- AI 接入与使用：确认任务、模型选择、数据和预算边界。
- MAWflow Fit：理解资源适配理由与不可变方案。
- 信任中心：理解账号、供应商凭据和高风险动作边界。
- MAWflow Studio 用户手册：了解团队项目中的 AI 辅助路径。