For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ja/docs/mobile/usage.md (or send Accept: text/markdown).
使用量とクレジット
計量制限、プリペイドクレジット、請求サーフェス。
使用量の状態を読む
GET /api/mobile/usage は、AI 予算をマイクロユニットの 10 進文字列 — budgetMicrounits、committedMicrounits、heldMicrounits、keyMode — 、プリペイドクレジット残高、label・used・limit・cap・planLimit・description を持つメーターごとの行、現在の期間の境界を返します。表示側はメーターを 80% で警告、100% で危険としてマークします。
値は JSON の数値ではなく 10 進文字列です — 大きな予算でも正確さを保つため、比較や整形の前にパースしてください。
プリペイドクレジット台帳
GET /api/mobile/credits はワークスペースのプリペイド残高と直近 50 件の台帳行を返します。残高は「設定 → 請求」とホームの使用量カードに反映されます。台帳の参照 ID はクライアントのペイロードには含まれません。
ホームと請求のサーフェス
ホーム画面は GET /api/workspace/metrics を再利用します — Web ダッシュボードが描画するのと同じ統計グリッドです。月次の AI 支出、タスクとスレッド数、メンバー、保留中の招待、プランの状態、未読通知が含まれます。使用量カードは AI の行と上限のあるメーターを表示し、クイックアクションタイルは chat、assistant、content、commerce、notifications、feedback、settings にリンクします。
「設定 → 請求」はプラン、有効期限、クレジット残高、使用量メーターを表示し、ストアと Web の請求の違いを説明し、ペイウォールにリンクします。サーバーのスケジュールが 15 分ごとにワークスペースを走査し、AI 予算の 80% と 100% で月に一度 owner と admin に通知します。
検証とトラブルシューティング
上限に近いメーター、使い切ったクレジット残高、デフォルト予算のワークスペースを確認してください。ブロックされた操作は、一般的なエラーではなく、拒否したメーターを指し示す必要があります。