請求アカウントの取得

GET /api/v1/billing/account

組織の請求アカウントのスナップショット(課金モード、残高、与信枠)を返します。

認証:本エンドポイントはコンソールバックエンド API(Base URL https://portal.aiin1.aiapi.portal.aiin1.ai ではありません)に属します。コンソールアカウントでログインして取得した access_token(15 分間有効)が必要で、sk-nex- API トークンは使用できません。ログイン方法は 請求照合と使用量自動同期 を参照してください。残高監視だけが目的なら、sk-nex- トークンでログイン不要の GET https://api.portal.aiin1.ai/v1/dashboard/billing/credit_grants を推奨します(同ガイドに記載)。

リクエスト例

curl https://portal.aiin1.ai/api/v1/billing/account \
  -H "Authorization: Bearer $ACCESS_TOKEN"

レスポンス

フィールド 必須 説明
id string(uuid) はい 請求アカウント ID
org_id string(uuid) はい 組織 ID
billing_mode string はい 課金モード:prepaid(前払い)/ postpaid(後払い)/ hybrid(ハイブリッド)
credit_balance_usd string(decimal) はい リアルタイム利用可能残高(USD。前払いの正、後払い / ハイブリッドでは意味を持ちません)
credit_limit_usd string(decimal) はい 与信枠(USD。後払い / ハイブリッドで使用)
updated_at string(datetime) はい 更新日時