gpuai-sdk

Programmatic API for GPU.ai. Authenticate with API keys minted from the dashboard. See https://gpu.ai/docs for details.

This Python package is automatically generated by the OpenAPI Generator project:

API version: 1.0.0
Package version: 0.3.2
Generator version: 7.24.0
Build package: org.openapitools.codegen.languages.PythonClientCodegen

Requirements.

Python 3.10+

Installation & Usage

pip install

Install from PyPI with pip install gpuai-sdk, or straight from the public source mirror:

pip install git+https://github.com/gpuai-dev/gpuai-python-sdk.git

(you may need to run pip with root permission: sudo pip install git+https://github.com/gpuai-dev/gpuai-python-sdk.git)

Then import the package:

import gpuai_sdk

Setuptools

Install from a mirror checkout (run from the checkout root):

pip install --user .

(or sudo pip install . to install the package for all users)

Then import the package:

import gpuai_sdk

Tests

Execute pytest to run the tests.

Getting Started

Please follow the installation procedure and then run the following:

import os

import gpuai_sdk
from gpuai_sdk.rest import ApiException
from pprint import pprint

# Defining the host is optional and defaults to https://api.gpu.ai/v1
# See configuration.py for a list of all supported configuration parameters.
configuration = gpuai_sdk.Configuration(
    host = "https://api.gpu.ai/v1"
)

# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.

# Configure Bearer authorization (gpuai_live_<24-base62>): bearerAuth
configuration = gpuai_sdk.Configuration(
    access_token = os.environ["BEARER_TOKEN"]
)


# Enter a context with an instance of the API client
with gpuai_sdk.ApiClient(configuration) as api_client:
    # Create an instance of the API class
    api_instance = gpuai_sdk.BillingApi(api_client)
    create_crypto_deposit_request = gpuai_sdk.CreateCryptoDepositRequest() # CreateCryptoDepositRequest | 

    try:
        # Create a stablecoin deposit
        api_response = api_instance.create_crypto_deposit(create_crypto_deposit_request)
        print("The response of BillingApi->create_crypto_deposit:\n")
        pprint(api_response)
    except ApiException as e:
        print("Exception when calling BillingApi->create_crypto_deposit: %s\n" % e)

Documentation for API Endpoints

All URIs are relative to https://api.gpu.ai/v1

Class	Method	HTTP request	Description
BillingApi	create_crypto_deposit	POST /billing/deposits/crypto	Create a stablecoin deposit
BillingApi	get_deposit	GET /billing/deposits/{id}	Get one stablecoin deposit
BillingApi	get_spending_limit	GET /billing/spending-limit	Get the org spending limit
BillingApi	list_deposits	GET /billing/deposits	List stablecoin deposits
BillingApi	update_spending_limit	PUT /billing/spending-limit	Set the org spending limit
CommunityApi	delist_community_machine	POST /community/machines/{id}/delist	Delist a Community Cloud machine
CommunityApi	enable_community_supplier	POST /community/suppliers	Enable the Community Cloud supplier role
CommunityApi	get_community_supplier_me	GET /community/suppliers/me	Get the caller's Community Cloud supplier
CommunityApi	list_community_machines	GET /community/machines	List your Community Cloud machines
CommunityApi	reclaim_community_machine	POST /community/machines/{id}/reclaim	Reclaim a spot-tier Community Cloud machine
CommunityApi	register_community_machine	POST /community/machines	Register a Community Cloud machine
EnvironmentsApi	get_environments	GET /environments	List launch environments (no auth required)
FineTuningApi	cancel_fine_tuning_job	POST /fine_tuning/jobs/{id}/cancel	Cancel a fine-tuning job (OpenAI-compatible)
FineTuningApi	create_file	POST /files	Upload a fine-tuning dataset file (OpenAI-compatible)
FineTuningApi	create_fine_tuning_job	POST /fine_tuning/jobs	Create a managed fine-tuning job (OpenAI-compatible)
FineTuningApi	get_fine_tuning_job	GET /fine_tuning/jobs/{id}	Retrieve a fine-tuning job (OpenAI-compatible)
FineTuningApi	list_fine_tuning_job_events	GET /fine_tuning/jobs/{id}/events	List fine-tuning job events (OpenAI-compatible)
FineTuningApi	list_fine_tuning_jobs	GET /fine_tuning/jobs	List fine-tuning jobs (OpenAI-compatible)
GpuTypesApi	list_gpu_types	GET /gpu-types	List available GPU types (no auth required)
InferenceApi	cancel_video	POST /videos/{id}/cancel	Cancel a video generation job
InferenceApi	create_chat_completion	POST /chat/completions	Create a chat completion (OpenAI-compatible)
InferenceApi	create_image	POST /images/generations	Create image (OpenAI-compatible)
InferenceApi	create_video	POST /videos	Create a video generation job (async)
InferenceApi	get_model	GET /models/{id}	Get a specific model (OpenAI-compatible)
InferenceApi	get_video	GET /videos/{id}	Get a video generation job
InferenceApi	get_video_content	GET /videos/{id}/content	Download a completed video artifact
InferenceApi	list_models	GET /models	List available models (OpenAI-compatible)
InferenceApi	list_videos	GET /videos	List video generation jobs
InstancesApi	create_instance	POST /instances	Create an instance (async — returns 202 + Operation-Id header)
InstancesApi	delete_instance	DELETE /instances/{id}	Terminate an instance (idempotent)
InstancesApi	get_instance	GET /instances/{id}	Get an instance
InstancesApi	list_instances	GET /instances	List instances
InstancesApi	update_instance	PATCH /instances/{id}	Update an instance (rename only in v1)
MetaApi	get_health	GET /health	Liveness probe
MetaApi	get_open_api_spec	GET /openapi.json	OpenAPI 3.1 specification
OperationsApi	get_operation	GET /operations/{id}	Get an async operation status
PricingApi	list_pricing	GET /pricing	List pricing per GPU type + region (no auth required)
SshKeysApi	create_ssh_key	POST /ssh-keys	Create an SSH key
SshKeysApi	delete_ssh_key	DELETE /ssh-keys/{id}	Delete an SSH key (idempotent — 404 on already-gone per D-07)
SshKeysApi	get_ssh_key	GET /ssh-keys/{id}	Get an SSH key
SshKeysApi	list_ssh_keys	GET /ssh-keys	List SSH keys
TemplatesApi	get_template	GET /templates/{id}	Get one deployable application template
TemplatesApi	list_templates	GET /templates	List deployable application templates
UsageApi	list_usage	GET /usage	Time-bucketed usage
WebhooksApi	create_webhook_endpoint	POST /webhook-endpoints	Create a webhook endpoint
WebhooksApi	delete_webhook_endpoint	DELETE /webhook-endpoints/{id}	Delete a webhook endpoint
WebhooksApi	get_webhook_endpoint	GET /webhook-endpoints/{id}	Get a webhook endpoint
WebhooksApi	list_webhook_endpoints	GET /webhook-endpoints	List webhook endpoints

Documentation For Models

Documentation For Authorization

Authentication schemes defined for the API:

bearerAuth

Type: Bearer authentication (gpuai_live_<24-base62>)

Author

support@gpu.ai

Metadata

Release files for gpuai-sdk 0.3.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for gpuai-sdk 0.3.2
File	Size	Uploaded
gpuai_sdk-0.3.2.tar.gz	97.5 kB	Aug 31, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for gpuai-sdk 0.3.2
File	Interpreter	ABI	Platform	Reset
gpuai_sdk-0.3.2-py3-none-any.whl 189.2 kB Aug 31, 2026	Python 3	none	any	Details

Total release size: 286.8 kB

Release files / gpuai_sdk-0.3.2.tar.gz

Download URL	gpuai_sdk-0.3.2.tar.gz
Size	97.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`1afd2b760e3bbb909e183e961bf3df1fd070e6451de620427f4f5e77dc7a909e`
BLAKE2b-256 checksum How to use checksums	`ccb2ab8455652a9a4c080f7a3d80c286d5c03bb9a4e2d8d0ab777075937c03f7`
Upload date	Aug 31, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/gpuai-dev/gpu-ai
Publishing commit: github.com/gpuai-dev/gpu-ai/tree/63951933311d0dcd3f17675d0f8173d640caec51

Workflow

Publishing configuration: github.com/gpuai-dev/gpu-ai/blob/63951933311d0dcd3f17675d0f8173d640caec51/.github/workflows/sdk-release.yml
Publishing logs: github.com/gpuai-dev/gpu-ai/actions/runs/33384550908/attempts/1

Artifact

Subject: gpuai_sdk-0.3.2.tar.gz
SHA-256 checksum: 1afd2b760e3bbb909e183e961bf3df1fd070e6451de620427f4f5e77dc7a909e Verifying attestations

Release files / gpuai_sdk-0.3.2-py3-none-any.whl

Download URL	gpuai_sdk-0.3.2-py3-none-any.whl
Size	189.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`23aa25027da99c831e5695dfbbe345350ccd45965d742cfae032ce6ad8830e1f`
BLAKE2b-256 checksum How to use checksums	`0ce818fcf355b8b1243e1a85eb4f58520767def4044d8587fa0819b41aa7bac6`
Upload date	Aug 31, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/gpuai-dev/gpu-ai
Publishing commit: github.com/gpuai-dev/gpu-ai/tree/63951933311d0dcd3f17675d0f8173d640caec51

Workflow

Publishing configuration: github.com/gpuai-dev/gpu-ai/blob/63951933311d0dcd3f17675d0f8173d640caec51/.github/workflows/sdk-release.yml
Publishing logs: github.com/gpuai-dev/gpu-ai/actions/runs/33384550908/attempts/1

Artifact

Subject: gpuai_sdk-0.3.2-py3-none-any.whl
SHA-256 checksum: 23aa25027da99c831e5695dfbbe345350ccd45965d742cfae032ce6ad8830e1f Verifying attestations