@gpuai/sdk 0.1.0

package/docs/PricingApi.md

@@ -0,0 +1,92 @@
+# PricingApi
+
+All URIs are relative to *https://api.gpu.ai/v1*
+
+| Method | HTTP request | Description |
+|------------- | ------------- | -------------|
+| [**listPricing**](PricingApi.md#listpricing) | **GET** /pricing | List pricing per GPU type + region (no auth required) |
+
+
+
+## listPricing
+
+> PricingPage listPricing(cursor, limit, gpuType, region, tier, includeUnavailable)
+
+List pricing per GPU type + region (no auth required)
+
+Lists every distinct offer (gpu_type, gpu_count, region, tier, price, boot class). Customer-identical offers are merged with availability summed. Offers with zero availability are omitted unless include_unavailable=true.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  PricingApi,
+} from '@gpuai/sdk';
+import type { ListPricingRequest } from '@gpuai/sdk';
+
+async function example() {
+  console.log("🚀 Testing @gpuai/sdk SDK...");
+  const api = new PricingApi();
+
+  const body = {
+    // string (optional)
+    cursor: cursor_example,
+    // number (optional)
+    limit: 56,
+    // string | Exact-match filter on gpu_type (optional)
+    gpuType: gpuType_example,
+    // string | Exact-match filter on canonical region code (optional)
+    region: region_example,
+    // 'spot' | 'on_demand' | Exact-match filter on tier (optional)
+    tier: tier_example,
+    // boolean | Include offers whose current availability is zero (optional)
+    includeUnavailable: true,
+  } satisfies ListPricingRequest;
+
+  try {
+    const data = await api.listPricing(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **cursor** | `string` |  | [Optional] [Defaults to `undefined`] |
+| **limit** | `number` |  | [Optional] [Defaults to `50`] |
+| **gpuType** | `string` | Exact-match filter on gpu_type | [Optional] [Defaults to `undefined`] |
+| **region** | `string` | Exact-match filter on canonical region code | [Optional] [Defaults to `undefined`] |
+| **tier** | `spot`, `on_demand` | Exact-match filter on tier | [Optional] [Defaults to `undefined`] [Enum: spot, on_demand] |
+| **includeUnavailable** | `boolean` | Include offers whose current availability is zero | [Optional] [Defaults to `false`] |
+
+### Return type
+
+[**PricingPage**](PricingPage.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`, `application/problem+json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | OK |  -  |
+| **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)
+

package/docs/PricingPage.md

@@ -0,0 +1,36 @@
+
+# PricingPage
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+`data` | [Array<Pricing>](Pricing.md)
+`nextCursor` | string
+
+## Example
+
+```typescript
+import type { PricingPage } from '@gpuai/sdk'
+
+// TODO: Update the object below with actual values
+const example = {
+  "data": null,
+  "nextCursor": null,
+} satisfies PricingPage
+
+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 PricingPage
+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/Problem.md

@@ -0,0 +1,44 @@
+
+# Problem
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+`type` | string
+`title` | string
+`status` | number
+`detail` | string
+`code` | string
+`requestId` | string
+
+## Example
+
+```typescript
+import type { Problem } from '@gpuai/sdk'
+
+// TODO: Update the object below with actual values
+const example = {
+  "type": null,
+  "title": null,
+  "status": null,
+  "detail": null,
+  "code": null,
+  "requestId": null,
+} satisfies Problem
+
+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 Problem
+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/RegisterCommunityMachineRequest.md

@@ -0,0 +1,45 @@
+
+# RegisterCommunityMachineRequest
+
+All fields optional; an empty body registers a zero-spec placeholder in pending_verification.
+
+## Properties
+
+Name | Type
+------------ | -------------
+`gpuType` | string
+`gpuCount` | number
+`vramPerGpuGb` | number
+`pricePerHour` | number
+`region` | string
+`tier` | string
+
+## Example
+
+```typescript
+import type { RegisterCommunityMachineRequest } from '@gpuai/sdk'
+
+// TODO: Update the object below with actual values
+const example = {
+  "gpuType": null,
+  "gpuCount": null,
+  "vramPerGpuGb": null,
+  "pricePerHour": null,
+  "region": null,
+  "tier": null,
+} satisfies RegisterCommunityMachineRequest
+
+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 RegisterCommunityMachineRequest
+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/SSHKey.md

@@ -0,0 +1,40 @@
+
+# SSHKey
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+`id` | string
+`name` | string
+`fingerprint` | string
+`createdAt` | Date
+
+## Example
+
+```typescript
+import type { SSHKey } from '@gpuai/sdk'
+
+// TODO: Update the object below with actual values
+const example = {
+  "id": null,
+  "name": null,
+  "fingerprint": null,
+  "createdAt": null,
+} satisfies SSHKey
+
+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 SSHKey
+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/SSHKeyPage.md

@@ -0,0 +1,36 @@
+
+# SSHKeyPage
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+`data` | [Array<SSHKey>](SSHKey.md)
+`nextCursor` | string
+
+## Example
+
+```typescript
+import type { SSHKeyPage } from '@gpuai/sdk'
+
+// TODO: Update the object below with actual values
+const example = {
+  "data": null,
+  "nextCursor": null,
+} satisfies SSHKeyPage
+
+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 SSHKeyPage
+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/SpendingLimit.md

@@ -0,0 +1,54 @@
+
+# SpendingLimit
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+`monthlyLimitCents` | number
+`monthlyLimitDollars` | number
+`currentMonthSpendCents` | number
+`currentMonthSpendDollars` | number
+`percentUsed` | number
+`billingCycleStart` | Date
+`enforcement` | string
+`autoTerminateHours` | number
+`dailyLimitCents` | number
+`dailyLimitDollars` | number
+`currentDaySpendCents` | number
+
+## Example
+
+```typescript
+import type { SpendingLimit } from '@gpuai/sdk'
+
+// TODO: Update the object below with actual values
+const example = {
+  "monthlyLimitCents": null,
+  "monthlyLimitDollars": null,
+  "currentMonthSpendCents": null,
+  "currentMonthSpendDollars": null,
+  "percentUsed": null,
+  "billingCycleStart": null,
+  "enforcement": null,
+  "autoTerminateHours": null,
+  "dailyLimitCents": null,
+  "dailyLimitDollars": null,
+  "currentDaySpendCents": null,
+} satisfies SpendingLimit
+
+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 SpendingLimit
+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/SshKeysApi.md

@@ -0,0 +1,305 @@
+# SshKeysApi
+
+All URIs are relative to *https://api.gpu.ai/v1*
+
+| Method | HTTP request | Description |
+|------------- | ------------- | -------------|
+| [**createSshKey**](SshKeysApi.md#createsshkeyoperation) | **POST** /ssh-keys | Create an SSH key |
+| [**deleteSshKey**](SshKeysApi.md#deletesshkey) | **DELETE** /ssh-keys/{id} | Delete an SSH key (idempotent — 404 on already-gone per D-07) |
+| [**getSshKey**](SshKeysApi.md#getsshkey) | **GET** /ssh-keys/{id} | Get an SSH key |
+| [**listSshKeys**](SshKeysApi.md#listsshkeys) | **GET** /ssh-keys | List SSH keys |
+
+
+
+## createSshKey
+
+> SSHKey createSshKey(createSshKeyRequest, idempotencyKey)
+
+Create an SSH key
+
+### Example
+
+```ts
+import {
+  Configuration,
+  SshKeysApi,
+} from '@gpuai/sdk';
+import type { CreateSshKeyOperationRequest } 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 SshKeysApi(config);
+
+  const body = {
+    // CreateSshKeyRequest
+    createSshKeyRequest: ...,
+    // string (optional)
+    idempotencyKey: idempotencyKey_example,
+  } satisfies CreateSshKeyOperationRequest;
+
+  try {
+    const data = await api.createSshKey(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **createSshKeyRequest** | [CreateSshKeyRequest](CreateSshKeyRequest.md) |  | |
+| **idempotencyKey** | `string` |  | [Optional] [Defaults to `undefined`] |
+
+### Return type
+
+[**SSHKey**](SSHKey.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`, `application/problem+json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **201** | Created |  -  |
+| **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)
+
+
+## deleteSshKey
+
+> deleteSshKey(id)
+
+Delete an SSH key (idempotent — 404 on already-gone per D-07)
+
+### Example
+
+```ts
+import {
+  Configuration,
+  SshKeysApi,
+} from '@gpuai/sdk';
+import type { DeleteSshKeyRequest } 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 SshKeysApi(config);
+
+  const body = {
+    // string
+    id: id_example,
+  } satisfies DeleteSshKeyRequest;
+
+  try {
+    const data = await api.deleteSshKey(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **id** | `string` |  | [Defaults to `undefined`] |
+
+### Return type
+
+`void` (Empty response body)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/problem+json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **204** | Deleted |  -  |
+| **404** | Already deleted (idempotent) |  -  |
+| **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)
+
+
+## getSshKey
+
+> SSHKey getSshKey(id)
+
+Get an SSH key
+
+### Example
+
+```ts
+import {
+  Configuration,
+  SshKeysApi,
+} from '@gpuai/sdk';
+import type { GetSshKeyRequest } 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 SshKeysApi(config);
+
+  const body = {
+    // string
+    id: id_example,
+  } satisfies GetSshKeyRequest;
+
+  try {
+    const data = await api.getSshKey(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **id** | `string` |  | [Defaults to `undefined`] |
+
+### Return type
+
+[**SSHKey**](SSHKey.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)
+
+
+## listSshKeys
+
+> SSHKeyPage listSshKeys(cursor, limit)
+
+List SSH keys
+
+Returns the SSH keys owned by the user the API key was minted by. Org-wide key visibility is an admin capability in the dashboard.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  SshKeysApi,
+} from '@gpuai/sdk';
+import type { ListSshKeysRequest } 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 SshKeysApi(config);
+
+  const body = {
+    // string (optional)
+    cursor: cursor_example,
+    // number (optional)
+    limit: 56,
+  } satisfies ListSshKeysRequest;
+
+  try {
+    const data = await api.listSshKeys(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **cursor** | `string` |  | [Optional] [Defaults to `undefined`] |
+| **limit** | `number` |  | [Optional] [Defaults to `50`] |
+
+### Return type
+
+[**SSHKeyPage**](SSHKeyPage.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)
+

package/docs/StreamOptions.md

@@ -0,0 +1,34 @@
+
+# StreamOptions
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+`includeUsage` | boolean
+
+## Example
+
+```typescript
+import type { StreamOptions } from '@gpuai/sdk'
+
+// TODO: Update the object below with actual values
+const example = {
+  "includeUsage": null,
+} satisfies StreamOptions
+
+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 StreamOptions
+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)
+
+