@gpuai/sdk 0.3.14 → 0.3.15

package/.openapi-generator/FILES

@@ -6,6 +6,7 @@ docs/AutolaunchRule.md
 docs/AutolaunchRuleCreate.md
 docs/AutolaunchRuleDisarm.md
 docs/AutolaunchRulePage.md
+docs/Balance.md
 docs/BillingApi.md
 docs/ChatChoice.md
 docs/ChatCompletionRequest.md
@@ -135,6 +136,7 @@ src/models/AutolaunchRule.ts
 src/models/AutolaunchRuleCreate.ts
 src/models/AutolaunchRuleDisarm.ts
 src/models/AutolaunchRulePage.ts
+src/models/Balance.ts
 src/models/ChatChoice.ts
 src/models/ChatCompletionRequest.ts
 src/models/ChatCompletionResponse.ts

package/README.md

@@ -1,4 +1,4 @@
-# @gpuai/sdk@0.3.14
+# @gpuai/sdk@0.3.15
 
 A TypeScript SDK client for the api.gpu.ai API.
 
@@ -62,6 +62,7 @@ All URIs are relative to *https://api.gpu.ai/v1*
 *AutolaunchApi* | [**getAutolaunchRule**](docs/AutolaunchApi.md#getautolaunchrule) | **GET** /autolaunch-rules/{id} | Get an auto-launch rule
 *AutolaunchApi* | [**listAutolaunchRules**](docs/AutolaunchApi.md#listautolaunchrules) | **GET** /autolaunch-rules | List auto-launch rules
 *BillingApi* | [**createCryptoDeposit**](docs/BillingApi.md#createcryptodepositoperation) | **POST** /billing/deposits/crypto | Create a stablecoin deposit
+*BillingApi* | [**getBalance**](docs/BillingApi.md#getbalance) | **GET** /billing/balance | Get the org credit balance
 *BillingApi* | [**getDeposit**](docs/BillingApi.md#getdeposit) | **GET** /billing/deposits/{id} | Get one stablecoin deposit
 *BillingApi* | [**getSpendingLimit**](docs/BillingApi.md#getspendinglimit) | **GET** /billing/spending-limit | Get the org spending limit
 *BillingApi* | [**listDeposits**](docs/BillingApi.md#listdeposits) | **GET** /billing/deposits | List stablecoin deposits
@@ -128,6 +129,7 @@ All URIs are relative to *https://api.gpu.ai/v1*
 - [AutolaunchRuleCreate](docs/AutolaunchRuleCreate.md)
 - [AutolaunchRuleDisarm](docs/AutolaunchRuleDisarm.md)
 - [AutolaunchRulePage](docs/AutolaunchRulePage.md)
+- [Balance](docs/Balance.md)
 - [ChatChoice](docs/ChatChoice.md)
 - [ChatCompletionRequest](docs/ChatCompletionRequest.md)
 - [ChatCompletionResponse](docs/ChatCompletionResponse.md)
@@ -233,7 +235,7 @@ and is automatically generated by the
 [OpenAPI Generator](https://openapi-generator.tech) project:
 
 - API version: `1.0.0`
-- Package version: `0.3.14`
+- Package version: `0.3.15`
 - Generator version: `7.24.0`
 - Build package: `org.openapitools.codegen.languages.TypeScriptFetchClientCodegen`
 

package/dist/apis/BillingApi.d.ts

@@ -10,6 +10,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
+import { type Balance } from '../models/Balance';
 import { type CreateCryptoDepositRequest } from '../models/CreateCryptoDepositRequest';
 import { type CryptoDeposit } from '../models/CryptoDeposit';
 import { type ListDeposits200Response } from '../models/ListDeposits200Response';
@@ -42,6 +43,20 @@ export declare class BillingApi extends runtime.BaseAPI {
      * Create a stablecoin deposit
      */
     createCryptoDeposit(requestParameters: CreateCryptoDepositOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CryptoDeposit>;
+    /**
+     * Creates request options for getBalance without sending the request
+     */
+    getBalanceRequestOpts(): Promise<runtime.RequestOpts>;
+    /**
+     * Returns the organization\'s credit balance, its auto-pay configuration, and the live burn rate. Requires the `billing:read` scope. The organization is taken from the authenticated API key, never from a parameter.  Divide `balance_cents` by `burn_cents_per_hour` for the remaining runway in hours. The quotient is undefined in three cases a caller must keep apart: `burn_cents_per_hour` is 0 (nothing running, so the balance funds unbounded idle time), it is `null` (the burn rate could not be determined — NOT the same as idle), or the balance is already at or below zero.  This is the balance itself — for spend against a configured cap see `/billing/spending-limit`, and for past consumption see `/usage`.
+     * Get the org credit balance
+     */
+    getBalanceRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Balance>>;
+    /**
+     * Returns the organization\'s credit balance, its auto-pay configuration, and the live burn rate. Requires the `billing:read` scope. The organization is taken from the authenticated API key, never from a parameter.  Divide `balance_cents` by `burn_cents_per_hour` for the remaining runway in hours. The quotient is undefined in three cases a caller must keep apart: `burn_cents_per_hour` is 0 (nothing running, so the balance funds unbounded idle time), it is `null` (the burn rate could not be determined — NOT the same as idle), or the balance is already at or below zero.  This is the balance itself — for spend against a configured cap see `/billing/spending-limit`, and for past consumption see `/usage`.
+     * Get the org credit balance
+     */
+    getBalance(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Balance>;
     /**
      * Creates request options for getDeposit without sending the request
      */

package/dist/apis/BillingApi.js

@@ -24,6 +24,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BillingApi = void 0;
 const runtime = require("../runtime");
+const Balance_1 = require("../models/Balance");
 const CreateCryptoDepositRequest_1 = require("../models/CreateCryptoDepositRequest");
 const CryptoDeposit_1 = require("../models/CryptoDeposit");
 const ListDeposits200Response_1 = require("../models/ListDeposits200Response");
@@ -82,6 +83,50 @@ class BillingApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Creates request options for getBalance without sending the request
+     */
+    getBalanceRequestOpts() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const queryParameters = {};
+            const headerParameters = {};
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield token("bearerAuth", []);
+                if (tokenString) {
+                    headerParameters["Authorization"] = `Bearer ${tokenString}`;
+                }
+            }
+            let urlPath = `/billing/balance`;
+            return {
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            };
+        });
+    }
+    /**
+     * Returns the organization\'s credit balance, its auto-pay configuration, and the live burn rate. Requires the `billing:read` scope. The organization is taken from the authenticated API key, never from a parameter.  Divide `balance_cents` by `burn_cents_per_hour` for the remaining runway in hours. The quotient is undefined in three cases a caller must keep apart: `burn_cents_per_hour` is 0 (nothing running, so the balance funds unbounded idle time), it is `null` (the burn rate could not be determined — NOT the same as idle), or the balance is already at or below zero.  This is the balance itself — for spend against a configured cap see `/billing/spending-limit`, and for past consumption see `/usage`.
+     * Get the org credit balance
+     */
+    getBalanceRaw(initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.getBalanceRequestOpts();
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, Balance_1.BalanceFromJSON)(jsonValue));
+        });
+    }
+    /**
+     * Returns the organization\'s credit balance, its auto-pay configuration, and the live burn rate. Requires the `billing:read` scope. The organization is taken from the authenticated API key, never from a parameter.  Divide `balance_cents` by `burn_cents_per_hour` for the remaining runway in hours. The quotient is undefined in three cases a caller must keep apart: `burn_cents_per_hour` is 0 (nothing running, so the balance funds unbounded idle time), it is `null` (the burn rate could not be determined — NOT the same as idle), or the balance is already at or below zero.  This is the balance itself — for spend against a configured cap see `/billing/spending-limit`, and for past consumption see `/usage`.
+     * Get the org credit balance
+     */
+    getBalance(initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.getBalanceRaw(initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Creates request options for getDeposit without sending the request
      */

package/dist/esm/apis/BillingApi.d.ts

@@ -10,6 +10,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
+import { type Balance } from '../models/Balance';
 import { type CreateCryptoDepositRequest } from '../models/CreateCryptoDepositRequest';
 import { type CryptoDeposit } from '../models/CryptoDeposit';
 import { type ListDeposits200Response } from '../models/ListDeposits200Response';
@@ -42,6 +43,20 @@ export declare class BillingApi extends runtime.BaseAPI {
      * Create a stablecoin deposit
      */
     createCryptoDeposit(requestParameters: CreateCryptoDepositOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CryptoDeposit>;
+    /**
+     * Creates request options for getBalance without sending the request
+     */
+    getBalanceRequestOpts(): Promise<runtime.RequestOpts>;
+    /**
+     * Returns the organization\'s credit balance, its auto-pay configuration, and the live burn rate. Requires the `billing:read` scope. The organization is taken from the authenticated API key, never from a parameter.  Divide `balance_cents` by `burn_cents_per_hour` for the remaining runway in hours. The quotient is undefined in three cases a caller must keep apart: `burn_cents_per_hour` is 0 (nothing running, so the balance funds unbounded idle time), it is `null` (the burn rate could not be determined — NOT the same as idle), or the balance is already at or below zero.  This is the balance itself — for spend against a configured cap see `/billing/spending-limit`, and for past consumption see `/usage`.
+     * Get the org credit balance
+     */
+    getBalanceRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Balance>>;
+    /**
+     * Returns the organization\'s credit balance, its auto-pay configuration, and the live burn rate. Requires the `billing:read` scope. The organization is taken from the authenticated API key, never from a parameter.  Divide `balance_cents` by `burn_cents_per_hour` for the remaining runway in hours. The quotient is undefined in three cases a caller must keep apart: `burn_cents_per_hour` is 0 (nothing running, so the balance funds unbounded idle time), it is `null` (the burn rate could not be determined — NOT the same as idle), or the balance is already at or below zero.  This is the balance itself — for spend against a configured cap see `/billing/spending-limit`, and for past consumption see `/usage`.
+     * Get the org credit balance
+     */
+    getBalance(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Balance>;
     /**
      * Creates request options for getDeposit without sending the request
      */

package/dist/esm/apis/BillingApi.js

@@ -21,6 +21,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import * as runtime from '../runtime';
+import { BalanceFromJSON, } from '../models/Balance';
 import { CreateCryptoDepositRequestToJSON, } from '../models/CreateCryptoDepositRequest';
 import { CryptoDepositFromJSON, } from '../models/CryptoDeposit';
 import { ListDeposits200ResponseFromJSON, } from '../models/ListDeposits200Response';
@@ -79,6 +80,50 @@ export class BillingApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Creates request options for getBalance without sending the request
+     */
+    getBalanceRequestOpts() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const queryParameters = {};
+            const headerParameters = {};
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield token("bearerAuth", []);
+                if (tokenString) {
+                    headerParameters["Authorization"] = `Bearer ${tokenString}`;
+                }
+            }
+            let urlPath = `/billing/balance`;
+            return {
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            };
+        });
+    }
+    /**
+     * Returns the organization\'s credit balance, its auto-pay configuration, and the live burn rate. Requires the `billing:read` scope. The organization is taken from the authenticated API key, never from a parameter.  Divide `balance_cents` by `burn_cents_per_hour` for the remaining runway in hours. The quotient is undefined in three cases a caller must keep apart: `burn_cents_per_hour` is 0 (nothing running, so the balance funds unbounded idle time), it is `null` (the burn rate could not be determined — NOT the same as idle), or the balance is already at or below zero.  This is the balance itself — for spend against a configured cap see `/billing/spending-limit`, and for past consumption see `/usage`.
+     * Get the org credit balance
+     */
+    getBalanceRaw(initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.getBalanceRequestOpts();
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => BalanceFromJSON(jsonValue));
+        });
+    }
+    /**
+     * Returns the organization\'s credit balance, its auto-pay configuration, and the live burn rate. Requires the `billing:read` scope. The organization is taken from the authenticated API key, never from a parameter.  Divide `balance_cents` by `burn_cents_per_hour` for the remaining runway in hours. The quotient is undefined in three cases a caller must keep apart: `burn_cents_per_hour` is 0 (nothing running, so the balance funds unbounded idle time), it is `null` (the burn rate could not be determined — NOT the same as idle), or the balance is already at or below zero.  This is the balance itself — for spend against a configured cap see `/billing/spending-limit`, and for past consumption see `/usage`.
+     * Get the org credit balance
+     */
+    getBalance(initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.getBalanceRaw(initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Creates request options for getDeposit without sending the request
      */

package/dist/esm/models/Balance.d.ts

@@ -0,0 +1,65 @@
+/**
+ * GPU.ai Public Developer API
+ * Programmatic API for GPU.ai. Authenticate with API keys minted from the dashboard. See https://gpu.ai/docs for details.
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * Contact: support@gpu.ai
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * The organization's credit balance with its auto-pay configuration and live burn rate. Mirrors the dashboard's balance contract field for field. No payment-instrument detail appears here — saved cards live behind separate admin-only routes.
+ *
+ * @export
+ * @interface Balance
+ */
+export interface Balance {
+    /**
+     * Remaining credit in USD cents. May be negative when usage has outrun the balance.
+     * @type {number}
+     * @memberof Balance
+     */
+    balanceCents: number;
+    /**
+     * The same figure in dollars, for display.
+     * @type {number}
+     * @memberof Balance
+     */
+    balanceDollars: number;
+    /**
+     *
+     * @type {boolean}
+     * @memberof Balance
+     */
+    autoPayEnabled: boolean;
+    /**
+     * Auto-pay triggers when the balance falls below this. Meaningful only when auto_pay_enabled.
+     * @type {number}
+     * @memberof Balance
+     */
+    autoPayThresholdCents: number;
+    /**
+     * Amount auto-pay charges when it triggers. Meaningful only when auto_pay_enabled.
+     * @type {number}
+     * @memberof Balance
+     */
+    autoPayAmountCents: number;
+    /**
+     * Live burn rate in USD cents per hour: the committed hourly price of every instance that is live, counted from launch — so instances still creating, provisioning or booting are included, not only those that have reached running. 0 when nothing is live.
+     *
+     * `null` means the burn rate could not be determined. Treat that as unknown, never as 0: reading an unavailable burn rate as "nothing running" reports unbounded runway to an organization that may be minutes from empty.
+     * @type {number}
+     * @memberof Balance
+     */
+    burnCentsPerHour: number | null;
+}
+/**
+ * Check if a given object implements the Balance interface.
+ */
+export declare function instanceOfBalance(value: object): value is Balance;
+export declare function BalanceFromJSON(json: any): Balance;
+export declare function BalanceFromJSONTyped(json: any, ignoreDiscriminator: boolean): Balance;
+export declare function BalanceToJSON(json: any): Balance;
+export declare function BalanceToJSONTyped(value?: Balance | null, ignoreDiscriminator?: boolean): any;

package/dist/esm/models/Balance.js

@@ -0,0 +1,63 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * GPU.ai Public Developer API
+ * Programmatic API for GPU.ai. Authenticate with API keys minted from the dashboard. See https://gpu.ai/docs for details.
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * Contact: support@gpu.ai
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Check if a given object implements the Balance interface.
+ */
+export function instanceOfBalance(value) {
+    if ((!('balanceCents' in value) && !('balance_cents' in value)) || (value['balanceCents'] === undefined && value['balance_cents'] === undefined))
+        return false;
+    if ((!('balanceDollars' in value) && !('balance_dollars' in value)) || (value['balanceDollars'] === undefined && value['balance_dollars'] === undefined))
+        return false;
+    if ((!('autoPayEnabled' in value) && !('auto_pay_enabled' in value)) || (value['autoPayEnabled'] === undefined && value['auto_pay_enabled'] === undefined))
+        return false;
+    if ((!('autoPayThresholdCents' in value) && !('auto_pay_threshold_cents' in value)) || (value['autoPayThresholdCents'] === undefined && value['auto_pay_threshold_cents'] === undefined))
+        return false;
+    if ((!('autoPayAmountCents' in value) && !('auto_pay_amount_cents' in value)) || (value['autoPayAmountCents'] === undefined && value['auto_pay_amount_cents'] === undefined))
+        return false;
+    if ((!('burnCentsPerHour' in value) && !('burn_cents_per_hour' in value)) || (value['burnCentsPerHour'] === undefined && value['burn_cents_per_hour'] === undefined))
+        return false;
+    return true;
+}
+export function BalanceFromJSON(json) {
+    return BalanceFromJSONTyped(json, false);
+}
+export function BalanceFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'balanceCents': json['balance_cents'],
+        'balanceDollars': json['balance_dollars'],
+        'autoPayEnabled': json['auto_pay_enabled'],
+        'autoPayThresholdCents': json['auto_pay_threshold_cents'],
+        'autoPayAmountCents': json['auto_pay_amount_cents'],
+        'burnCentsPerHour': json['burn_cents_per_hour'],
+    };
+}
+export function BalanceToJSON(json) {
+    return BalanceToJSONTyped(json, false);
+}
+export function BalanceToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'balance_cents': value['balanceCents'],
+        'balance_dollars': value['balanceDollars'],
+        'auto_pay_enabled': value['autoPayEnabled'],
+        'auto_pay_threshold_cents': value['autoPayThresholdCents'],
+        'auto_pay_amount_cents': value['autoPayAmountCents'],
+        'burn_cents_per_hour': value['burnCentsPerHour'],
+    };
+}

package/dist/esm/models/index.d.ts

@@ -2,6 +2,7 @@ export * from './AutolaunchRule';
 export * from './AutolaunchRuleCreate';
 export * from './AutolaunchRuleDisarm';
 export * from './AutolaunchRulePage';
+export * from './Balance';
 export * from './ChatChoice';
 export * from './ChatCompletionRequest';
 export * from './ChatCompletionResponse';

package/dist/esm/models/index.js

@@ -4,6 +4,7 @@ export * from './AutolaunchRule';
 export * from './AutolaunchRuleCreate';
 export * from './AutolaunchRuleDisarm';
 export * from './AutolaunchRulePage';
+export * from './Balance';
 export * from './ChatChoice';
 export * from './ChatCompletionRequest';
 export * from './ChatCompletionResponse';

package/dist/models/Balance.d.ts

@@ -0,0 +1,65 @@
+/**
+ * GPU.ai Public Developer API
+ * Programmatic API for GPU.ai. Authenticate with API keys minted from the dashboard. See https://gpu.ai/docs for details.
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * Contact: support@gpu.ai
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * The organization's credit balance with its auto-pay configuration and live burn rate. Mirrors the dashboard's balance contract field for field. No payment-instrument detail appears here — saved cards live behind separate admin-only routes.
+ *
+ * @export
+ * @interface Balance
+ */
+export interface Balance {
+    /**
+     * Remaining credit in USD cents. May be negative when usage has outrun the balance.
+     * @type {number}
+     * @memberof Balance
+     */
+    balanceCents: number;
+    /**
+     * The same figure in dollars, for display.
+     * @type {number}
+     * @memberof Balance
+     */
+    balanceDollars: number;
+    /**
+     *
+     * @type {boolean}
+     * @memberof Balance
+     */
+    autoPayEnabled: boolean;
+    /**
+     * Auto-pay triggers when the balance falls below this. Meaningful only when auto_pay_enabled.
+     * @type {number}
+     * @memberof Balance
+     */
+    autoPayThresholdCents: number;
+    /**
+     * Amount auto-pay charges when it triggers. Meaningful only when auto_pay_enabled.
+     * @type {number}
+     * @memberof Balance
+     */
+    autoPayAmountCents: number;
+    /**
+     * Live burn rate in USD cents per hour: the committed hourly price of every instance that is live, counted from launch — so instances still creating, provisioning or booting are included, not only those that have reached running. 0 when nothing is live.
+     *
+     * `null` means the burn rate could not be determined. Treat that as unknown, never as 0: reading an unavailable burn rate as "nothing running" reports unbounded runway to an organization that may be minutes from empty.
+     * @type {number}
+     * @memberof Balance
+     */
+    burnCentsPerHour: number | null;
+}
+/**
+ * Check if a given object implements the Balance interface.
+ */
+export declare function instanceOfBalance(value: object): value is Balance;
+export declare function BalanceFromJSON(json: any): Balance;
+export declare function BalanceFromJSONTyped(json: any, ignoreDiscriminator: boolean): Balance;
+export declare function BalanceToJSON(json: any): Balance;
+export declare function BalanceToJSONTyped(value?: Balance | null, ignoreDiscriminator?: boolean): any;

package/dist/models/Balance.js

@@ -0,0 +1,70 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * GPU.ai Public Developer API
+ * Programmatic API for GPU.ai. Authenticate with API keys minted from the dashboard. See https://gpu.ai/docs for details.
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * Contact: support@gpu.ai
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.instanceOfBalance = instanceOfBalance;
+exports.BalanceFromJSON = BalanceFromJSON;
+exports.BalanceFromJSONTyped = BalanceFromJSONTyped;
+exports.BalanceToJSON = BalanceToJSON;
+exports.BalanceToJSONTyped = BalanceToJSONTyped;
+/**
+ * Check if a given object implements the Balance interface.
+ */
+function instanceOfBalance(value) {
+    if ((!('balanceCents' in value) && !('balance_cents' in value)) || (value['balanceCents'] === undefined && value['balance_cents'] === undefined))
+        return false;
+    if ((!('balanceDollars' in value) && !('balance_dollars' in value)) || (value['balanceDollars'] === undefined && value['balance_dollars'] === undefined))
+        return false;
+    if ((!('autoPayEnabled' in value) && !('auto_pay_enabled' in value)) || (value['autoPayEnabled'] === undefined && value['auto_pay_enabled'] === undefined))
+        return false;
+    if ((!('autoPayThresholdCents' in value) && !('auto_pay_threshold_cents' in value)) || (value['autoPayThresholdCents'] === undefined && value['auto_pay_threshold_cents'] === undefined))
+        return false;
+    if ((!('autoPayAmountCents' in value) && !('auto_pay_amount_cents' in value)) || (value['autoPayAmountCents'] === undefined && value['auto_pay_amount_cents'] === undefined))
+        return false;
+    if ((!('burnCentsPerHour' in value) && !('burn_cents_per_hour' in value)) || (value['burnCentsPerHour'] === undefined && value['burn_cents_per_hour'] === undefined))
+        return false;
+    return true;
+}
+function BalanceFromJSON(json) {
+    return BalanceFromJSONTyped(json, false);
+}
+function BalanceFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'balanceCents': json['balance_cents'],
+        'balanceDollars': json['balance_dollars'],
+        'autoPayEnabled': json['auto_pay_enabled'],
+        'autoPayThresholdCents': json['auto_pay_threshold_cents'],
+        'autoPayAmountCents': json['auto_pay_amount_cents'],
+        'burnCentsPerHour': json['burn_cents_per_hour'],
+    };
+}
+function BalanceToJSON(json) {
+    return BalanceToJSONTyped(json, false);
+}
+function BalanceToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'balance_cents': value['balanceCents'],
+        'balance_dollars': value['balanceDollars'],
+        'auto_pay_enabled': value['autoPayEnabled'],
+        'auto_pay_threshold_cents': value['autoPayThresholdCents'],
+        'auto_pay_amount_cents': value['autoPayAmountCents'],
+        'burn_cents_per_hour': value['burnCentsPerHour'],
+    };
+}

package/dist/models/index.d.ts

@@ -2,6 +2,7 @@ export * from './AutolaunchRule';
 export * from './AutolaunchRuleCreate';
 export * from './AutolaunchRuleDisarm';
 export * from './AutolaunchRulePage';
+export * from './Balance';
 export * from './ChatChoice';
 export * from './ChatCompletionRequest';
 export * from './ChatCompletionResponse';

package/dist/models/index.js

@@ -20,6 +20,7 @@ __exportStar(require("./AutolaunchRule"), exports);
 __exportStar(require("./AutolaunchRuleCreate"), exports);
 __exportStar(require("./AutolaunchRuleDisarm"), exports);
 __exportStar(require("./AutolaunchRulePage"), exports);
+__exportStar(require("./Balance"), exports);
 __exportStar(require("./ChatChoice"), exports);
 __exportStar(require("./ChatCompletionRequest"), exports);
 __exportStar(require("./ChatCompletionResponse"), exports);

package/docs/Balance.md

@@ -0,0 +1,45 @@
+
+# Balance
+
+The organization\'s credit balance with its auto-pay configuration and live burn rate. Mirrors the dashboard\'s balance contract field for field. No payment-instrument detail appears here — saved cards live behind separate admin-only routes. 
+
+## Properties
+
+Name | Type
+------------ | -------------
+`balanceCents` | number
+`balanceDollars` | number
+`autoPayEnabled` | boolean
+`autoPayThresholdCents` | number
+`autoPayAmountCents` | number
+`burnCentsPerHour` | number
+
+## Example
+
+```typescript
+import type { Balance } from '@gpuai/sdk'
+
+// TODO: Update the object below with actual values
+const example = {
+  "balanceCents": null,
+  "balanceDollars": null,
+  "autoPayEnabled": null,
+  "autoPayThresholdCents": null,
+  "autoPayAmountCents": null,
+  "burnCentsPerHour": null,
+} satisfies Balance
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as Balance
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/docs/BillingApi.md

@@ -5,6 +5,7 @@ All URIs are relative to *https://api.gpu.ai/v1*
 | Method | HTTP request | Description |
 |------------- | ------------- | -------------|
 | [**createCryptoDeposit**](BillingApi.md#createcryptodepositoperation) | **POST** /billing/deposits/crypto | Create a stablecoin deposit |
+| [**getBalance**](BillingApi.md#getbalance) | **GET** /billing/balance | Get the org credit balance |
 | [**getDeposit**](BillingApi.md#getdeposit) | **GET** /billing/deposits/{id} | Get one stablecoin deposit |
 | [**getSpendingLimit**](BillingApi.md#getspendinglimit) | **GET** /billing/spending-limit | Get the org spending limit |
 | [**listDeposits**](BillingApi.md#listdeposits) | **GET** /billing/deposits | List stablecoin deposits |
@@ -89,6 +90,71 @@ example().catch(console.error);
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
+## getBalance
+
+> Balance getBalance()
+
+Get the org credit balance
+
+Returns the organization\'s credit balance, its auto-pay configuration, and the live burn rate. Requires the `billing:read` scope. The organization is taken from the authenticated API key, never from a parameter.  Divide `balance_cents` by `burn_cents_per_hour` for the remaining runway in hours. The quotient is undefined in three cases a caller must keep apart: `burn_cents_per_hour` is 0 (nothing running, so the balance funds unbounded idle time), it is `null` (the burn rate could not be determined — NOT the same as idle), or the balance is already at or below zero.  This is the balance itself — for spend against a configured cap see `/billing/spending-limit`, and for past consumption see `/usage`. 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  BillingApi,
+} from '@gpuai/sdk';
+import type { GetBalanceRequest } from '@gpuai/sdk';
+
+async function example() {
+  console.log("🚀 Testing @gpuai/sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: bearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new BillingApi(config);
+
+  try {
+    const data = await api.getBalance();
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+This endpoint does not need any parameter.
+
+### Return type
+
+[**Balance**](Balance.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`, `application/problem+json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | OK |  -  |
+| **429** | Rate limit exceeded (RFC 7807). Retry-After header indicates seconds to wait. |  * Retry-After - Seconds the client should wait before retrying. <br>  |
+| **0** | Error response (RFC 7807) |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
 ## getDeposit
 
 > CryptoDeposit getDeposit(id)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gpuai/sdk",
-  "version": "0.3.14",
+  "version": "0.3.15",
   "description": "TypeScript SDK for the GPU.ai Public Developer API",
   "author": "GPU.ai Support <support@gpu.ai>",
   "repository": {

package/src/apis/BillingApi.ts

@@ -13,6 +13,11 @@
  */
 
 import * as runtime from '../runtime';
+import {
+    type Balance,
+    BalanceFromJSON,
+    BalanceToJSON,
+} from '../models/Balance';
 import {
     type CreateCryptoDepositRequest,
     CreateCryptoDepositRequestFromJSON,
@@ -118,6 +123,53 @@ export class BillingApi extends runtime.BaseAPI {
         return await response.value();
     }
 
+    /**
+     * Creates request options for getBalance without sending the request
+     */
+    async getBalanceRequestOpts(): Promise<runtime.RequestOpts> {
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/billing/balance`;
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Returns the organization\'s credit balance, its auto-pay configuration, and the live burn rate. Requires the `billing:read` scope. The organization is taken from the authenticated API key, never from a parameter.  Divide `balance_cents` by `burn_cents_per_hour` for the remaining runway in hours. The quotient is undefined in three cases a caller must keep apart: `burn_cents_per_hour` is 0 (nothing running, so the balance funds unbounded idle time), it is `null` (the burn rate could not be determined — NOT the same as idle), or the balance is already at or below zero.  This is the balance itself — for spend against a configured cap see `/billing/spending-limit`, and for past consumption see `/usage`. 
+     * Get the org credit balance
+     */
+    async getBalanceRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Balance>> {
+        const requestOptions = await this.getBalanceRequestOpts();
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => BalanceFromJSON(jsonValue));
+    }
+
+    /**
+     * Returns the organization\'s credit balance, its auto-pay configuration, and the live burn rate. Requires the `billing:read` scope. The organization is taken from the authenticated API key, never from a parameter.  Divide `balance_cents` by `burn_cents_per_hour` for the remaining runway in hours. The quotient is undefined in three cases a caller must keep apart: `burn_cents_per_hour` is 0 (nothing running, so the balance funds unbounded idle time), it is `null` (the burn rate could not be determined — NOT the same as idle), or the balance is already at or below zero.  This is the balance itself — for spend against a configured cap see `/billing/spending-limit`, and for past consumption see `/usage`. 
+     * Get the org credit balance
+     */
+    async getBalance(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Balance> {
+        const response = await this.getBalanceRaw(initOverrides);
+        return await response.value();
+    }
+
     /**
      * Creates request options for getDeposit without sending the request
      */

package/src/models/Balance.ts

@@ -0,0 +1,114 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * GPU.ai Public Developer API
+ * Programmatic API for GPU.ai. Authenticate with API keys minted from the dashboard. See https://gpu.ai/docs for details. 
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * Contact: support@gpu.ai
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+import { mapValues } from '../runtime';
+/**
+ * The organization's credit balance with its auto-pay configuration and live burn rate. Mirrors the dashboard's balance contract field for field. No payment-instrument detail appears here — saved cards live behind separate admin-only routes.
+ * 
+ * @export
+ * @interface Balance
+ */
+export interface Balance {
+    /**
+     * Remaining credit in USD cents. May be negative when usage has outrun the balance.
+     * @type {number}
+     * @memberof Balance
+     */
+    balanceCents: number;
+    /**
+     * The same figure in dollars, for display.
+     * @type {number}
+     * @memberof Balance
+     */
+    balanceDollars: number;
+    /**
+     * 
+     * @type {boolean}
+     * @memberof Balance
+     */
+    autoPayEnabled: boolean;
+    /**
+     * Auto-pay triggers when the balance falls below this. Meaningful only when auto_pay_enabled.
+     * @type {number}
+     * @memberof Balance
+     */
+    autoPayThresholdCents: number;
+    /**
+     * Amount auto-pay charges when it triggers. Meaningful only when auto_pay_enabled.
+     * @type {number}
+     * @memberof Balance
+     */
+    autoPayAmountCents: number;
+    /**
+     * Live burn rate in USD cents per hour: the committed hourly price of every instance that is live, counted from launch — so instances still creating, provisioning or booting are included, not only those that have reached running. 0 when nothing is live.
+     * 
+     * `null` means the burn rate could not be determined. Treat that as unknown, never as 0: reading an unavailable burn rate as "nothing running" reports unbounded runway to an organization that may be minutes from empty.
+     * @type {number}
+     * @memberof Balance
+     */
+    burnCentsPerHour: number | null;
+}
+
+/**
+ * Check if a given object implements the Balance interface.
+ */
+export function instanceOfBalance(value: object): value is Balance {
+    if ((!('balanceCents' in (value as Record<string, any>)) && !('balance_cents' in (value as Record<string, any>))) || ((value as Record<string, any>)['balanceCents'] === undefined && (value as Record<string, any>)['balance_cents'] === undefined)) return false;
+    if ((!('balanceDollars' in (value as Record<string, any>)) && !('balance_dollars' in (value as Record<string, any>))) || ((value as Record<string, any>)['balanceDollars'] === undefined && (value as Record<string, any>)['balance_dollars'] === undefined)) return false;
+    if ((!('autoPayEnabled' in (value as Record<string, any>)) && !('auto_pay_enabled' in (value as Record<string, any>))) || ((value as Record<string, any>)['autoPayEnabled'] === undefined && (value as Record<string, any>)['auto_pay_enabled'] === undefined)) return false;
+    if ((!('autoPayThresholdCents' in (value as Record<string, any>)) && !('auto_pay_threshold_cents' in (value as Record<string, any>))) || ((value as Record<string, any>)['autoPayThresholdCents'] === undefined && (value as Record<string, any>)['auto_pay_threshold_cents'] === undefined)) return false;
+    if ((!('autoPayAmountCents' in (value as Record<string, any>)) && !('auto_pay_amount_cents' in (value as Record<string, any>))) || ((value as Record<string, any>)['autoPayAmountCents'] === undefined && (value as Record<string, any>)['auto_pay_amount_cents'] === undefined)) return false;
+    if ((!('burnCentsPerHour' in (value as Record<string, any>)) && !('burn_cents_per_hour' in (value as Record<string, any>))) || ((value as Record<string, any>)['burnCentsPerHour'] === undefined && (value as Record<string, any>)['burn_cents_per_hour'] === undefined)) return false;
+    return true;
+}
+
+export function BalanceFromJSON(json: any): Balance {
+    return BalanceFromJSONTyped(json, false);
+}
+
+export function BalanceFromJSONTyped(json: any, ignoreDiscriminator: boolean): Balance {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'balanceCents': json['balance_cents'],
+        'balanceDollars': json['balance_dollars'],
+        'autoPayEnabled': json['auto_pay_enabled'],
+        'autoPayThresholdCents': json['auto_pay_threshold_cents'],
+        'autoPayAmountCents': json['auto_pay_amount_cents'],
+        'burnCentsPerHour': json['burn_cents_per_hour'],
+    };
+}
+
+export function BalanceToJSON(json: any): Balance {
+    return BalanceToJSONTyped(json, false);
+}
+
+export function BalanceToJSONTyped(value?: Balance | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'balance_cents': value['balanceCents'],
+        'balance_dollars': value['balanceDollars'],
+        'auto_pay_enabled': value['autoPayEnabled'],
+        'auto_pay_threshold_cents': value['autoPayThresholdCents'],
+        'auto_pay_amount_cents': value['autoPayAmountCents'],
+        'burn_cents_per_hour': value['burnCentsPerHour'],
+    };
+}
+

package/src/models/index.ts

@@ -4,6 +4,7 @@ export * from './AutolaunchRule';
 export * from './AutolaunchRuleCreate';
 export * from './AutolaunchRuleDisarm';
 export * from './AutolaunchRulePage';
+export * from './Balance';
 export * from './ChatChoice';
 export * from './ChatCompletionRequest';
 export * from './ChatCompletionResponse';