請求アカウントの取得
GET /api/v1/billing/account
組織の請求アカウントのスナップショット(課金モード、残高、与信枠)を返します。
認証:本エンドポイントはコンソールバックエンド API(Base URL
https://portal.aiin1.ai、api.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) | はい | 更新日時 |