GET /v1/balance

この読み取り専用エンドポイントは API キーを検証しますが、プラスの残高は必要ありません。

リクエスト

curl https://api.model-gate.com/v1/balance \
  -H "Authorization: Bearer mg_live_..."

応答

{
  "object": "balance",
  "currency": "USD",
  "balance": "12.3400000000"
}

個人認証情報の場合、残高はキーを所有するユーザーに属します。ビジネス認証情報の場合、API 料金は常に会社所有者のウォレットを使用します。共有会社残高は、資格情報プリンシパルが会社レベルの残高表示 (組織所有者、管理者、または請求ロール) を持っている場合にのみ返されます。従業員の開発者/閲覧者の資格情報は、許可された API リクエストを実行できますが、HTTP 403 を受信します。 /v1/balance;これらのユーザーには、コントロール パネルで許可されているグループの使用量と制限のみが表示されます。 APIキー usage そして spend_limit 別々の値のままです。

認証エラー

{
  "error": {
    "type": "authentication_error",
    "code": "invalid_api_key",
    "message": "invalid API key"
  }
}

ビジネス許可エラー

{
  "error": {
    "type": "permission_error",
    "code": "balance_not_permitted",
    "message": "Company balance is not available for this credential principal."
  }
}