Luma API 余额查询与 Dream Machine Credits 接入教程

不接入密钥，手动查看旧版余额

1. 打开旧版 Billing & Credits 页面，自行登录实际支付 API 费用的账户。
2. 查看 API 钱包金额、账户上下文和观察时间；与 Web/App 订阅点数及新版 Agents 账务分开。
3. 旧账务页面不可用或跳转新平台时，使用新平台自己的账务页面并向 Luma 核对迁移，无需提供 Key、调用付费模型或充值。

在 Quota Monitor 中接入 Luma / Dream Machine（旧版 API）

1. 01

   确认您仍在使用旧版 API

   私下检查现有应用配置：本连接对应 api.lumalabs.ai/dream-machine/v1 和实际支付该服务的旧版 API Key。打开下面的官方旧版 Billing & Credits 页面，确认当前账户和 API 钱包。

   若配置使用 agents.lumalabs.ai/v1 或 luma-api- Key，您使用的是新版 Agents API。本连接不覆盖其钱包或 Enterprise 报告，请手动查账，不提交新版 Key 或猜测兼容。

   打开官方旧版 API 页面（在新标签页打开）
2. 02

   打开同一账户的旧版 Keys 页面

   保持登录同一账户，打开下面官方 Keys 入口，核对网址为 https://lumalabs.ai/dream-machine/api/keys，确认其归属就是要监控的旧版 API 付费账户。

   如果不再提供旧版密钥管理，或只进入 platform.lumalabs.ai，请停止并向官方核对迁移状态。不要复制浏览器会话、Cookie、密码或 Enterprise Admin Key 作为替代。

   打开官方旧版 API 页面（在新标签页打开）
3. 03

   创建独立的旧版 API Key

   在旧版 Keys 页使用创建密钥入口；若有名称字段，可填 QuotaMonitorBalance。完整值显示时立即私下保存，不覆盖现有应用 Key，也不撤销其他业务的凭据。

   官方未确认旧 Key 有余额专用只读 scope。这个 Key 仍能生成媒体、消耗资金，本站只查询 Credits。不能接受此托管权限时，使用下方手动查看步骤。

4. 04

   在 Quota Monitor 项目内添加连接

   打开目标项目并添加供应商连接，选择「Luma / Dream Machine（旧版 API）」，填写便于识别的连接名，把独立 Key 粘贴到遮蔽凭据框并保存。MCP 用户通过安全输入链接填写。

   币种为 USD，上游项目/Key 筛选留空。不填写自定义主机、账户覆盖或整段 Authorization。本站项目仅整理监控，不会创建独立上游钱包。

5. 05

   检查首次同步是否成功

   等待首次自动查询，或在页面提示的等待时间结束后刷新一次。成功判据是出现新的成功同步时间及旧版 API Credits 金额。

   服务端只执行 GET https://api.lumalabs.ai/dream-machine/v1/credits，附 Bearer 认证，不生成内容、不购买 Credits、不跟随重定向。失败时检查最新同步错误，旧金额和旧时间仍显示不代表新查询成功。

6. 06

   用正确钱包核对美分换算

   回到同一旧版 Billing & Credits 页面，对比 API 余额和观察时间。credit_balance=7550 应为 $75.50，credit_balance=12.5 应为 $0.125。lumaBalance.balance 保留精确美元，balanceCents 保留原始美分。

   不要与 Web 订阅点数或新版 Agents 钱包比较。金额不同时先确认账号、Key 来源及账务更新时间，再等待同步；无需为测试运行付费模型或充值。

   打开官方旧版 API 页面（在新标签页打开）
7. 07

   检查共享资金与退役通知

   多个项目或 Key 显示相同金额时，可能引用同一个旧版账户钱包。适当复用既有连接，不把重复资金相加。

   查看您账号实际收到的 Luma 退役通知。新版迁移说明中的 luma-api- Key 和新主机不证明旧余额接口覆盖新版钱包。旧连接不再对应实际计费时请停用。

8. 08

   更换或停用本站专用密钥

   需要轮换时，在同一旧版 Keys 页生成替代 Key，通过本站安全表单更新凭据，确认余额查询成功后再到官方撤销旧的专用监控 Key。

   删除本站连接不会撤销上游 Key。只撤销本人这个监控 Key，不影响应用 Key 或全部账户凭据。迁移后无法管理旧 Key 时，先停用本站连接并联系官方。

   打开官方旧版 API 页面（在新标签页打开）

Quota Monitor 读取的 Luma / Dream Machine（旧版 API） 数据范围

• 仅支持旧版 Dream Machine 开发者钱包。Web/App 订阅和月度点数独立；新版 agents.lumalabs.ai、luma-api- Key 和 Enterprise Admin 用量报告不能与此钱包互换。
• 官方要求以账号收到的模型退役通知日期为准。不要为了本教程新建旧版账号或购买 Credits。旧 Keys/Billing 页面若只跳转至其他平台，请停止接入并手动查看对应平台账务。
• 不再扣用量、不加订阅额度、不推算余额。重复连接可能引用同一笔钱，不能相加。零、负数和小数美分精确保留；缺失/null 或查询失败保留上次成功金额与时间，资金不保证模型可用。
• 看板展示最近一次成功查询的快照。手动刷新会重新请求供应商，但不保证上游账务没有入账延迟；失败时旧余额不能当成新结果。

Luma / Dream Machine（旧版 API） 常见问题与排查

可以用新版 luma-api- Key 吗？

不可以。它属于新版 Agents API。本连接校验旧凭据，不跨域尝试；Enterprise Admin read-only Key 查询的是企业用量，不是本旧版钱包。

为什么 7550 显示为 $75.50？

官方旧版 credit_balance 单位为 USD 美分，可含小数美分，只精确除以 100 一次。它不是 Web 订阅点数，也不是可直接按美元显示的值。

401 或 403 怎么排查？

确认独立 Key 来自正确旧版账户且完整、有效；撤销后通过安全表单更换。不扩大权限、不用密码，也不把 Key 发给客服或聊天。

404 或重定向怎么办？

核对账号旧版服务是否退役或迁移。本站不会携带 Key 跟随跳转或猜测新地址，请手动查看新版账务并向 Luma 核对迁移。

为什么网页或其他项目金额不同？

Web/App 订阅、旧版 API 与新版 Agents 是不同账务上下文。核对账户/Key 与观察时间；多个本站项目可能共用旧版资金，不重复汇总。

429、5xx 或缺少余额会怎样？

等待限流或故障恢复，在页面允许时重试。缺失/null credit_balance 或错误响应使查询失败，旧成功金额与时间保留，不把失败猜为零。

Luma / Dream Machine（旧版 API） 官方资料

• 官方旧版 Credits 查询（在新标签页打开）
• 官方美分定义（在新标签页打开）
• 官方旧版 OpenAPI 合同（在新标签页打开）
• 新版 Agents 迁移及凭据边界（在新标签页打开）
• 企业 Admin 只读 API 范围（在新标签页打开）
• 网页订阅与 API Credits 的区别（在新标签页打开）

教程由 Quota Monitor 整理，非供应商官方教程。平台界面和权限可能变化，请以官方页面为准；实测范围以本页说明为准。