ガイド更新日：
公式文書に基づく実装で、実アカウントの検証は未完了です。キー作成、権限、ワークスペースの選択、管理画面との照合をご自身で確認してください。自動テストは実測の代わりではありません。
- 必要な認証情報
- Segmind API Key
- 監視通貨
- USD · ドル建て Credits
- 監視の対象
- ワークスペース Credits · USD
- 固定 GET https://api.segmind.com/v1/get-user-credits で Personal またはチームの credits を取得します（scope=provider_workspace）。公式請求ページの Credits はドル建てで、credits=25 は $25 です。Quota Monitor プロジェクトの専用資金やメンバーの支出上限ではありません。
キーを共有せず Segmind Credits を確認
- 公式コンソールにログインし、左下の切替メニューで支払う Personal またはチームを選びます。
- Billing の Credits Balance を確認します。Cost Analytics の費用やメンバーの日・週・月の上限とは比較しません。
- 実行中の処理や承認された入金が反映された後に再確認します。手動確認で Quota Monitor に秘密値を送る必要はありません。
Segmind を Quota Monitor に接続する
支払うワークスペースを選ぶ
platform.segmind.com にログインし、左下の切替メニューからアプリが利用する Personal またはチームを選び、Billing を開きます。
ワークスペース名と Credits Balance を確認してください。監視設定のために新しいチーム、モデル実行、購入は必要ありません。
API Keys を開く
左ナビゲーション下部の Developer → API Keys を開き、新規キーの作成操作から監視専用キーを作ります。
既存の業務キーは変更しません。公式形式は SG_ と16桁の16進数です。JWT、キー名、マスクされた末尾は秘密値ではありません。
作成前に権限を確認する
名前欄があれば Quota Monitor balance など識別できる名前を入力します。新しいキーのモデルアクセスや期限の設定があれば確認して作成を完了します。
残高専用 scope や全モデルを拒否するポリシーは公開文書で未確認です。Member ロール、支出上限、空のモデル一覧が読み取り専用になるとは限りません。許容できなければ下の手動確認を使ってください。
完全な秘密値を安全に保管する
新しい API Key が表示されている間に安全な保管先へコピーし、対象の Personal またはチームに属していることを確認します。
x-api-key: や引用符を含めず、値だけコピーします。チャット、URL、スクリーンショットへ貼らないでください。紛失時は他の本番キーを転用せず、代替キーを作成します。
プロジェクト内で接続する
Quota Monitor の対象プロジェクト → プロバイダー接続追加 → 新規接続 → Segmind（USD）を選びます。識別しやすい接続名とマスクされた API Key 欄に入力し保存します。
ワークスペース ID、独自 URL、上流プロジェクトやキーのフィルターは不要です。Quota Monitor のプロジェクトは Segmind の共有資金を分割しません。
初回同期を照合する
初回同期を待つか、クールダウン後に更新します。新しい成功時刻を確認し、同じワークスペースの Billing と照合します。credits=25 は $25 で、$0.25 ではありません。
free-credits=2 は別表示で、合計 $27 にはしません。REST/MCP の segmindBalance.balance とカード主額を比較し、取得時間差と管理画面の丸めを考慮してください。
残高が少ないときは公式 Billing へ
カードの Open provider から Billing を開きます。ログイン中のワークスペースを確認した後、権限のある人が Recharge や Auto-recharge を判断します。
Quota Monitor は支払いや自動入金設定を変更しません。入金の反映後に再取得してください。メンバー上限やモデル制限は別に確認します。
安全に交換または停止する
通常の交換では新しい専用キーを作り、安全なフォームで既存接続を更新して同期を確認後、Developer → API Keys で古い監視キーを取り消します。漏洩が疑われる場合は直ちに失効させます。
プロジェクトの関連解除は上流キーの失効や他のプロジェクトが使う接続の削除ではありません。別々に処理し、無関係な業務キーを変更しないでください。
Quota Monitor が取得する Segmind のデータ範囲
- 主額は利用可能な credits です。free-credits は別項目で、有料・サブスクリプション資金との加算関係は定義されていません。加算、現金・特典の推測、他社の換算率の適用はしません。
- 複数のキーと Quota Monitor プロジェクトが同じ上流ワークスペースの資金を共有し得ます。重複集計や使用料の再控除はせず、管理画面も同じ範囲で比較します。
- 無料の残高 GET のみを実行します。モデル、ログイン、キー管理、入金、権限変更は行いません。REST/MCP の segmindBalance.balance と freeCredits は同じスナップショットです。
- 取得時刻は決済時刻ではありません。実行中の処理で資金が予約されても表示額は変わらない場合があります。メンバー上限やモデル制限もあるため、正の残高は実行可能性を保証しません。
- ゼロと負数を保持します。欠落、不正な応答、失敗時は前回成功時の額と時刻を残し、ゼロを捏造しません。Credits はサービス用で、出金可能な現金ではありません。
- ダッシュボードには、最後に成功した照会結果を表示します。手動更新で再照会できますが、プロバイダーの請求反映の遅延は解消できません。照会が失敗したあとに残る古い残高は、新しい結果ではありません。
Segmind のよくある質問とトラブルシューティング
- 401 や 403 が出たら？
- Developer → API Keys で完全な SG_ キーが有効か確認します。JWT や Cookie を代用せず、闇雲に権限を増やしたり本番キーで回避したりしないでください。不明なら手動確認を使います。
- 404 の意味は？
- 公式残高 API は Credits の記録がない場合に 404 を返します。対象ワークスペースの Billing または Segmind サポートで確認してください。資金がゼロという意味ではなく、非公開 API への再試行もしません。
- 無料 Credits を足さないのはなぜ？
- 公式の credits が利用可能残高で、free-credits は加算ルールなしに別で返されます。別表示とし、返金可能な現金や無制限のモデル権限だと判断しないでください。
- チームの表示額が違う場合は？
- キーが属するワークスペースを確認し、コンソールでも同じ Personal またはチームを選びます。別チーム、Cost Analytics、メンバー上限、Quota Monitor の予算とは比較しません。実行中の処理が終わった後に再確認します。
- 429 や invalid_response の後は？
- 次に更新できるまで待ってください。拒否や不完全な応答は前回成功の金額と時刻を保持し、新しいゼロにしません。サポートにはマスク済みのエラーコードと時刻のみを渡し、キーは送らないでください。
- 実アカウントの検証は済んでいますか？
- まだです。キー作成、権限、Personal/チームの範囲、初回同期額を検証し、公式 Billing とカードおよび REST/MCP を照合してください。配備や合成テストは実測の代わりではありません。
Segmind の公式資料
- 公式資料 · docs.segmind.com/docs/platform/account-and-billing-apis（新しいタブで開きます）
- 公式資料 · docs.segmind.com/docs/get-started/authentication（新しいタブで開きます）
- 公式資料 · docs.segmind.com/docs/platform/settings（新しいタブで開きます）
- 公式資料 · docs.segmind.com/docs/platform/teams（新しいタブで開きます）
- 公式資料 · docs.segmind.com/docs/platform/pricing-and-billing（新しいタブで開きます）
Quota Monitor が作成したガイドで、プロバイダーの公式チュートリアルではありません。画面や権限は変更される場合があるため、公式ページも確認してください。検証済みの範囲は、ここに記載した内容に限られます。