ガイド更新日：
2026-10-15 に確認した公式旧 API 文書に基づきます。実アカウントの権限、旧画面の利用可否と金額はユーザー検証待ちです。新しい Luma Agents API は対象外です。
- 必要な認証情報
- 旧 Dream Machine API キー
- 監視通貨
- USD
- 監視の対象
- 旧 API Credits · USD
- 固定 GET https://api.lumalabs.ai/dream-machine/v1/credits。credit_balance は USD セント単位で、7550 は $75.50 です。lumaBalance.balance = credit_balance / 100、balanceCents は元の値を保持します。scope=legacy_api_account は旧認証アカウントの共有 API 財布です。
キーを接続せず旧残高を手動確認する
- 旧 Billing & Credits を開き、API 支払い口座へ自分でログインします。
- API 財布金額、対象口座、確認時刻を読みます。Web/App 契約枠と新 Agents 請求とは分けます。
- 旧請求ページがない、または新画面へ移る場合はそちらで確認し、移行状態を Luma に確認します。キー、有料生成、入金は不要です。
Luma / Dream Machine（旧 API） を Quota Monitor に接続する
旧 API を利用中か確認する
既存アプリの設定を非公開で確認します。本接続は api.lumalabs.ai/dream-machine/v1 と、その旧 API の支払い用キーを対象にします。下の公式旧 Billing & Credits で対象アカウントと API 財布を確認します。
agents.lumalabs.ai/v1 または luma-api- キーなら新 Agents API です。その財布や Enterprise レポートは対象外なので、キーをここに送らず新画面で手動確認します。
同じ口座の旧 Keys ページを開く
同じ口座でログインしたまま下の公式 Keys を開き、URL が https://lumalabs.ai/dream-machine/api/keys であること、監視したい旧 API の支払い口座であることを確認します。
旧キー管理がなく platform.lumalabs.ai のみへ移る場合は止め、公式に移行状況を確認します。ブラウザーのセッション、Cookie、パスワード、Enterprise Admin キーで代用しません。
専用の旧 API キーを作る
旧 Keys の作成操作を使います。名前欄があれば QuotaMonitorBalance などを付け、秘密が表示されたら非公開で保存します。アプリの既存キーを上書き、失効しません。
旧キーの残高専用読み取り scope は公式確認できていません。キー自体はメディア生成と課金が可能ですが、当サービスは Credits のみ取得します。預けられない場合は下の手動確認を使います。
Quota Monitor の対象プロジェクトに追加する
対象プロジェクトで接続追加を開き、Luma / Dream Machine（旧 API）を選びます。識別できる名前を付け、専用キーだけをマスク欄へ貼り保存します。MCP では安全な資格情報入力リンクを使います。
USD を使い、上流プロジェクト/キーのフィルターは空欄にします。ホスト、口座上書き、Authorization 全文は不要です。プロジェクトは監視を整理する単位で、新しい上流財布を作りません。
初回同期の成功を確認する
最初の自動取得を待つか、画面の待機時間後に一度更新します。新しい成功時刻と旧 API Credits の金額があることを確認します。
サーバーは GET https://api.lumalabs.ai/dream-machine/v1/credits に Bearer 認証を付けるだけです。生成、購入、転送先への追従は行いません。失敗時は最新エラーを読み、古い金額と時刻を新しい成功と判断しません。
正しい財布でセント換算を照合する
同じ旧 Billing & Credits に戻り、API 金額と確認時刻を比較します。credit_balance=7550 は $75.50、credit_balance=12.5 は $0.125 です。lumaBalance.balance は正確な USD、balanceCents は元の USD セントです。
Web 契約枠や新 Agents 財布とは比較しません。違う場合は口座、キーの発行元、請求反映時刻を確認して再取得します。検証のために有料生成や入金を行う必要はありません。
共有資金と終了通知を確認する
複数プロジェクトやキーが同額なら、同じ旧 API 財布を参照している可能性があります。適切なら既存接続を再利用し、重複額を合算しません。
自分の口座に届いた Luma の終了通知を読みます。移行文書の新 luma-api- キーと新 URL は、旧 Credits が新財布を返す証拠ではありません。現行請求を示さなくなった旧接続は無効にします。
監視専用キーだけを交換・終了する
同じ旧 Keys で替わりのキーを作り、当サービスの安全なフォームで更新します。残高取得の成功後に旧監視キーだけを公式画面で失効させます。
当サービスから接続を削除しても上流キーは失効しません。アプリ用や全口座キーは操作せず、移行後に旧キーを管理できない場合は接続を無効にして公式へ相談します。
Quota Monitor が取得する Luma / Dream Machine（旧 API） のデータ範囲
- 旧 Dream Machine 開発者財布だけが対象です。Web/App 契約の月間枠、新 agents.lumalabs.ai、luma-api- キー、Enterprise Admin 使用量は別の仕組みです。
- 旧モデルの終了日は各アカウントへの公式通知を確認します。この手順のために旧口座を作成したり Credits を購入しません。旧 Keys/Billing が新プラットフォームへ移るだけなら接続せず、そちらで手動確認します。
- 使用料を再控除せず、契約枠の加算や残高推測もしません。同じ資金の接続を合算せず、ゼロ、負値、小数セントを正確に保持します。欠落/null や取得失敗では直前の成功額と時刻を残し、モデル利用は保証しません。
- ダッシュボードには、最後に成功した照会結果を表示します。手動更新で再照会できますが、プロバイダーの請求反映の遅延は解消できません。照会が失敗したあとに残る古い残高は、新しい結果ではありません。
Luma / Dream Machine（旧 API） のよくある質問とトラブルシューティング
- 新しい luma-api- キーは使えますか？
- 使えません。新 Agents API 用です。旧資格情報のみを検証し、他ドメインで試しません。Enterprise Admin read-only キーは企業使用量用で、この財布用ではありません。
- 7550 が $75.50 になるのは？
- 公式旧 credit_balance は小数も含む USD セントです。一度だけ正確に 100 で割ります。Web 契約のクレジット数や、そのまま USD にする値ではありません。
- 401 または 403 の確認箇所は？
- 正しい旧口座の専用キーか、完全で有効か確認します。失効していれば安全なフォームで交換します。権限を拡大せず、パスワードを使わず、キーをチャットやサポートへ送りません。
- 404 やリダイレクトの場合は？
- 旧 API の終了・移行状態を確認します。キー付きで転送を追ったり新 URL を推測しません。新請求画面で手動確認し、Luma に移行について相談します。
- Web や別プロジェクトと金額が違うのは？
- Web/App 契約、旧 API、新 Agents は別の請求範囲です。口座/キーと確認時刻を比較します。複数プロジェクトの同じ旧資金を合算しません。
- 429、5xx、残高欠落時は？
- 制限や障害の解消を待ち、画面の待機時間内に再試行します。欠落/null credit_balance やエラーは失敗として扱い、前回成功額と時刻を残します。失敗をゼロへ変えません。
Luma / Dream Machine（旧 API） の公式資料
- 公式資料 · docs.lumalabs.ai/reference/getcredits（新しいタブで開きます）
- 公式資料 · docs.lumalabs.ai/changelog/callbacks-and-credits-balance（新しいタブで開きます）
- 公式資料 · github.com/lumalabs/lumaai-api/blob/main/openapi.yaml（新しいタブで開きます）
- 公式資料 · docs.agents.lumalabs.ai/guides/videos/migration/（新しいタブで開きます）
- 公式資料 · docs.agents.lumalabs.ai/admin-api/（新しいタブで開きます）
- 公式資料 · lumalabs.ai/learning-hub/payments-subscriptions（新しいタブで開きます）
Quota Monitor が作成したガイドで、プロバイダーの公式チュートリアルではありません。画面や権限は変更される場合があるため、公式ページも確認してください。検証済みの範囲は、ここに記載した内容に限られます。