ガイド更新日：
公式資料に基づく実装です。実アカウントでの検証は未完了です。キー作成、権限、組織、金額と手順を確認してください。自動テストは実額の照合ではありません。
- 必要な認証情報
- Featherless 組織 Admin API キー
- 監視通貨
- USD · 米ドル
- 監視の対象
- 組織の利用可能 Credits · USD
- 固定 GET https://api.featherless.ai/credits/balance。available_nano_usd / 1000000000 が USD 利用可能額です。総額と予約額は別表示（scope=organization）。公式例 available_nano_usd=42488000000 は $42.488 です。
キーを共有せず手動で確認する
- Featherless にログインし、アカウントのダッシュボードから Billing を開きます。
- 支払組織の Developer USD Credits を確認します。固定チャットプランや Hugging Face の請求と比較しません。
- 総額、画面にあれば予約額／利用可能額と時刻を記録します。精算遅延を考慮し、キーは外部に渡しません。
Featherless AI を Quota Monitor に接続する
組織と請求方式を確認する
下の Featherless 公式サイトでご自身でログインし、アカウントのダッシュボードから Billing を開きます。API の支払組織が Developer / request pricing を使用しているか確認します。
確認点：USD Credits と時刻を記録します。監視テストだけのためにプラン変更、契約、入金をしないでください。
既存の Admin 権限を確認する
組織所有者にキー所有者が既に Admin であることを確認してもらいます。残高 API は manage_billing を確認し、Editor、Developer、Viewer のキーは使えません。
確認点：高権限キーの保管が組織で承認されていること。残高専用ポリシーは公開されていません。監視のためだけに権限を昇格させないでください。
専用 API キーを作成する
下の API Keys ページを承認済みアカウント／組織で開きます。Create New API Key をクリックし、Quota Monitor と命名して Generate を選びます。
確認点：本番キーをリセットせず、独立した新しいキーを作成します。画面や権限が異なる場合は管理者に確認してください。
秘密値を安全に保存する
表示された完全なキーをコピーし、パスワードマネージャーに保存します。公式手順では一度だけ表示されます。Bearer、Authorization:、引用符、空白を含めないでください。
確認点：チャット、スクリーンショット、URL、MCP 引数には入れません。組織 ID や独自 API URL は不要です。
プロジェクト内に接続を追加する
Quota Monitor の対象プロジェクトで接続追加を選び、Featherless AI を指定します。識別しやすい名前を付け、マスクされた入力欄にキーを貼り付けて保存します。MCP は安全な入力リンクを使います。
確認点：通貨は USD 固定です。プロジェクト／キーの絞り込みはできず、別プロジェクトへの関連付けで資金は分割されません。
初回同期の成功を確認する
自動同期を待つか、一度手動更新します。成功状態と更新時刻を両方確認し、更新待機時間の表示に従います。
確認点：失敗後の旧金額は最新結果ではありません。欠落や null をゼロと扱わないでください。
三つの金額を照合する
同じ組織の Billing に戻り、近い時刻に同じ項目を比較します。公式例では総額 $42.5、予約額 $0.012、利用可能額 $42.488 です。
確認点：featherlessBalance.balance は総額ではなく利用可能額です。五分間の精算と処理中のリクエストを考慮し、差分の推測や予約額の二重控除をしません。
キーを管理して実環境検証を完了する
残高が少ない場合はカードの公式サイトボタンから Featherless に戻り、アカウントの Billing を開きます。支払いは承認された所有者が判断します。
確認点：承認された新しいキーで同期を確認してから旧キーを失効させます。関連付け解除や接続削除では提供元キーは失効しません。報告は伏字のエラーと時刻だけにします。
Quota Monitor が取得する Featherless AI のデータ範囲
- Developer / request-pricing 組織の共有 Credits が対象です。出金可能な現金、プロジェクト別資金、キー上限ではありません。同じ資金を複数接続で合計しないでください。
- 利用可能額は予約額を控除済みです。reserved_nano_usd や使用額を再度引きません。整数 nano-USD を正確に換算し、表示用 _usd 値で置き換えません。
- 公式処理は五分間の精算単位で、実際の通信より遅れる場合があります。更新時刻は精算完了やモデルの利用保証ではありません。固定チャットプランや専用 GPU 契約は対象外です。
- Hugging Face 経由で同社に請求される分は対象外です。hf_ token を使わないでください。チャットプランに保存された Credits はプランの残り枠ではありません。
- REST/MCP の featherlessBalance.balance、totalBalance、reservedBalance は正確な USD 文字列です。settlementBasis=five_minute_windows。欠落、null、不整合は失敗として以前のスナップショットを保持し、ゼロや負の利用可能額はそのまま扱います。
- ダッシュボードには、最後に成功した照会結果を表示します。手動更新で再照会できますが、プロバイダーの請求反映の遅延は解消できません。照会が失敗したあとに残る古い残高は、新しい結果ではありません。
Featherless AI のよくある質問とトラブルシューティング
- 401：キーが拒否される？
- API Keys の完全な秘密値と失効状態を確認し、ヘッダー接頭辞や空白を除きます。Cookie や hf_ token は代用できません。
- 403 / organization_permission_denied？
- manage_billing を持つ組織 Admin のキーが必要です。モデル権限だけでは不十分です。所有者に所属組織と既存の役割を確認し、権限拡大や Cookie で回避しないでください。
- 利用可能額が画面の大きな金額と異なる？
- 画面は総 Credits を示している場合があります。利用可能額は処理中リクエストの予約額を控除済みです。同じ組織と時刻で比較し、予約額を二重に引かないでください。
- 欠落、null、invalid_response？
- 三つの整数 nano-USD と currency=usd が必要です。不正形式や不整合では以前の成功金額と時刻を維持します。伏字のエラーだけを共有してください。
- 404、429、タイムアウト？
- 時間を置いて再試行し、表示時刻も確認します。対応パスは /credits/balance であり /v1/credits/balance ではありません。ミラーホストや URL 内キーを使わないでください。
- 固定プランや Hugging Face の請求も確認できる？
- できません。チャット、専用容量、Hugging Face 経由の請求は別の範囲です。プラン変更後も Credits は保存される場合がありますが、使用されるのは request pricing 時のみで、プランの残り枠ではありません。
Featherless AI の公式資料
- 公式資料 · featherless.ai/docs/api-reference-credits（新しいタブで開きます）
- 公式資料 · featherless.ai/docs/request-pricing-and-credits（新しいタブで開きます）
- 公式資料 · featherless.ai/docs/guides-roo-code（新しいタブで開きます）
- 公式資料 · featherless.ai/docs/api-overview-and-common-options（新しいタブで開きます）
- 公式資料 · featherless.ai/docs/hugging-face（新しいタブで開きます）
- 公式資料 · featherless.ai/docs/billing（新しいタブで開きます）
Quota Monitor が作成したガイドで、プロバイダーの公式チュートリアルではありません。画面や権限は変更される場合があるため、公式ページも確認してください。検証済みの範囲は、ここに記載した内容に限られます。