教程更新
官方账务读取已实现;真实 Key 创建、最低角色行为、已登录导航和账户费用对账待用户测试。不会代登录、调用收费模型、充值或提升权限。
- 所需凭据
- 目标账户的独立普通 API Key
- 监控币种
- USD · 计价费用,非余额
- 可以看到什么
- 本 UTC 月账户已报告费用
- 固定 GET https://api.fireworks.ai/v1/accounts/{account_id}/billing/summary,Bearer 认证。startTime 为当前 UTC 月首,endTime 为下一 UTC 日零点(不含该日),日期聚合忽略时间部分。仅精确汇总顶层 lineItems[].totalCost:USD units + nanos / 1000000000,例如 units=0、nanos=125000000 是 $0.125,不除 100、不按数量乘单价、不再加 usageBuckets。balanceAmount=null,fireworksCost.queryEnd 是请求边界,不是已报告到的时刻。
不向本站提供 Key,在官方手动查看
- 打开官方控制台并选择实际计费账户,在现有用量/账务页面查看 Total Spend;不为测试支付或修改自动充值。
- 选择同一当前 UTC 月日期范围与账户整体费用,记录金额和时间;若界面时区或区间不同,不把图表直接等同 API 请求范围。费用可延迟一天以上,当天尚未完整。
- 单独查看余额/Credits、消费配额、通知与发票。无法接受普通 Key 权限时保持手动查询,不提高角色或购买套餐。
在 Quota Monitor 中接入 Fireworks AI · 账户费用
确认既有 Fireworks 账户与计费范围
打开 Fireworks 控制台,选中实际承担 API 费用的既有账户。账户是最高层计费资源,成员与其模型、部署和训练可能共用同一账务;不是 Quota Monitor 的业务项目。不要把公开模型名称中的 accounts/fireworks 当成自己的付款账户。
本教程只监控账户计价费用,不读取钱包或 Fire Pass 剩余额度。无现成账户/访问权限或不能接受普通 Key 风险时,使用下方官方手动查看,不购买准入、接受新邀请或升级套餐。
选择现有身份,不为监控扩权
官方 Usage & Cost Breakdown 说明同目标账户任一 API Key 可用,角色表列出 Inference User、Contributor、User、Admin 均能创建自己的 Key;最低既有 Inference User 也可运行收费推理,不是只读账务角色。
只使用自己已获授权的身份与独立普通 Key。没有已确认的单账务 scope 或权限 JSON,不要求 Admin、创建服务账户或调整角色。403 时先核对账户/Key,不能通过授予更多权限排错;真实最小角色组合仍待用户测试。
创建独立普通 API Key 并私下保存
打开下方 API Keys 页面,确认仍是第 1 步账户,选择 Create API key;名称可填 QuotaMonitorCosts。完成当前界面要求后立即私下保存完整值,Key 只显示一次;官方 API 支持 expireTime,但不假定 UI 一定提供到期控件。
名称和到期时间不会使 Key 变只读。不要再生、删除或覆盖其他应用的业务 Key,也不执行 Quickstart 的模型示例。只取普通账户 Key,不复制 Authorization 整行、Cookie、Fire Pass 专用凭据或任何会话密码。
私下确认 account_id,而非猜测模型账户
用本人不共享、不云同步、关闭历史与请求日志的本地 HTTP 工具,建立 GET https://api.fireworks.ai/v1/accounts?readMask=name,displayName。Key 只放 Authorization: Bearer 请求头,不加请求体、不跟随重定向。按返回 displayName 核对目标账户,只复制 name 中 accounts/ 后面的 account_id。
有 nextPageToken 时,仅在相同官方地址使用 pageToken 取下一页并保持 readMask,不把返回值当 URL。ID 为 1–63 个小写字母/数字/连字符,字母开头且不以连字符结尾。已配置官方 firectl 的用户也可私下用 firectl account get 核对;本站不调用身份/账户列表,不收集身份明细,核对后关闭工具。
在目标项目安全录入连接与账户 ID
回到 Quota Monitor 目标项目,添加连接,选择「Fireworks AI · 账户费用(USD)」。填写可识别名称,将完整普通 Key 放入遮蔽凭据框,在项目绑定的必填账户 ID 框填第 4 步 slug;不填 accounts/ 前缀、显示名称、模型/部署 ID、Key ID 或 URL。
币种固定 USD,不设项目/Key 筛选或日消耗估计。MCP 流程先用安全链接保存 Key,再在项目绑定中指定账户 ID,不能把 Key 发给聊天助手。凭据加密存储;帮助抽屉和公开教程共享正文,打开帮助不会提交连接或触发供应商读取。
首次同步并按同一 UTC 日期范围对账
保存后等待首次同步或用既有刷新操作,确认成功查询时间更新。报表从当前 UTC 月 1 日到下一 UTC 日零点(排除该日):例如 10 月 16 日查询,endTime 为 10 月 17 日,才能包含 16 日已报告部分。queryEnd 不是源数据已覆盖到该时刻。
核对同账户、同日期的计价费用:lineItems[].totalCost 的 units=0、nanos=125000000 表示 $0.125。保留九位小数与带符号调整,不重复加 usageBuckets,不用 quantity×unitAmount 重算。REST/MCP 读取同一快照,失败、空对象、缺金额或非 USD 保留旧金额与时间;明确空 lineItems 数组才表示本报告零费用。
单独核对 Credits、延迟与消费上限
在官方账户现有用量/账务界面核对 Total Spend,并确保日期/账户范围一致。费用可能延迟一天以上且响应会缓存数分钟,当天未完整;控制台区间或时区不同时不要直接等同比较。需要精确复核时,可在第 4 步本地工具按本教程的固定汇总 GET 和相同 startTime/endTime 查询,只保留金额与时间。
钱包、Credit grants/purchases、月上限和最终账单分别查看。本连接返回 not_queried 是未读取 monthly-spend-usd,不代表未配置。Enterprise 月支出通知与其他账户的强制暂停阈值不同;可选内部预算只算参考差额,不改供应商资金、限额或重置时间。
轮换与排错,不扩权或发收费请求
需要轮换时,在同账户仅新建替代监控 Key,经本站安全更新入口替换,成功同步后再撤销旧监控 Key;不要动其他应用的 Key。401 检查完整值、到期/撤销;403 先检查 Key 与 account_id 的归属,404 检查账户 ID 与接口契约,429 等待退避。
只分享错误码、查询时间和脱敏现象,不贴 Key、原始响应或截图。同步失败保留旧成功快照,不把旧时间当新成功;缺少数据不估算零。不能通过管理员权限、购买、网页 Cookie、猜测端点或收费模型测试排错,真实账号与对账仍待用户验收。
Quota Monitor 读取的 Fireworks AI · 账户费用 数据范围
- 账户整体计价用量费用覆盖报表所列 serverless、dedicated、training 类别,不是模型/Key 专属金额、钱包余额、赠送或购买 Credits、Fire Pass 套餐余量或最终发票。不同项目可能共享同一账户费用,不重复相加;不按 Token 价格估算缺失项目。
- 请求当前月并包含当天日期,但当天尚未完整。官方说明计价费用和 Total Spend 可延迟一天以上,结果也会缓存数分钟;没有可承诺的最迟同步时刻。queryStart/queryEnd 与 UTC 是请求范围,不冒充源报表水位或供应商重置时间。
- 本连接未读取官方 monthly-spend-usd 配额;officialLimit=unavailable/not_queried,不是 not_configured,也不代表 Fireworks 无配额 API。Enterprise 消费通知与其他账户强制上限不同;不拼接时区不明的月配额推算资金。内部预算差额仅参考,不改变上限、可调用性或给出耗尽日期。
- 面板展示最近一次成功的费用快照。刷新无法消除上游账务延迟;失败后保留的旧费用和旧时间不是新报表。
Fireworks AI · 账户费用 常见问题与排查
- 为什么有费用却没有余额或月上限余量?
- 此连接只读计价费用,balanceAmount=null;officialLimit 是 unavailable/not_queried,不是零余额或无限资金。Fireworks 有公开配额接口,但此版未读取,内部预算差额不是官方额度。
- 为什么当天费用少了或突然跳高?
- 日聚合费用可延迟一天以上,缓存数分钟;跳高可能是延迟入账,不等于流量突增。queryEnd 是下一 UTC 日的排除边界,不证明供应商已报告到该时刻,不按 Token 价格补齐。
- account_id 在哪里找?
- 按第 4 步用官方 GET /v1/accounts?readMask=name,displayName 私下核对目标账户,复制 name 的 accounts/ 后部分。公开模型所属 fireworks、部署 ID、Key ID 和显示名称不是付款账户 ID。不要把 Key 或列表发到聊天。
- 403 是否需要改为 Admin?
- 不要。官方账务说明同账户任一 Key 可用,角色表允许 Inference User 创建自己的 Key,但真实最小权限行为尚待核验。先核对同账户、完整有效 Key 与访问范围;无法解决时停止,不创建管理员 Key 或修改角色。
- 如何读 units、nanos 与 usageBuckets?
- 顶层 lineItems[].totalCost 是权威 USD Money;units 一单位是一美元,nanos 为十亿分之一美元。0 与 125000000 表示 $0.125,负调整也保留;usageBuckets 是重复分桶,不能再次累加或按数量/单价重建。
- 401、404、429 或字段变化怎么办?
- 401 检查有效期/撤销和粘贴;404 核对账户 ID;429 等待退避。缺总额、混币、错误响应整次失败并保留旧成功时间,不把未知当零。普通 Key 风险不可接受时用官方手动查账,不以充值或扩权排错。
Fireworks AI · 账户费用 官方资料
- 官方 Quickstart 与普通 Key 入口(在新标签页打开)
- 角色与自己的 Key 权限(在新标签页打开)
- 创建 API Key 契约与到期(在新标签页打开)
- 账户列表与 readMask(在新标签页打开)
- 账务汇总日期与 Money(在新标签页打开)
- 费用范围、认证与延迟(在新标签页打开)
- 公开配额读取契约(本连接未读取)(在新标签页打开)
- 月上限与 Enterprise 提醒(在新标签页打开)
- 账户层级与资源 ID 规则(在新标签页打开)
教程由 Quota Monitor 整理,非供应商官方教程。平台界面和权限可能变化,请以官方页面为准;实测范围以本页说明为准。