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.2.5
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)

    try:
        # Get the org spending limit
        api_response = api_instance.get_spending_limit()
        print("The response of BillingApi->get_spending_limit:\n")
        pprint(api_response)
    except ApiException as e:
        print("Exception when calling BillingApi->get_spending_limit: %s\n" % e)

Documentation for API Endpoints

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

Class	Method	HTTP request	Description
BillingApi	get_spending_limit	GET /billing/spending-limit	Get the org spending limit
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_earnings	GET /community/earnings	Get your Community Cloud earnings
CommunityApi	get_community_machine	GET /community/machines/{id}	Get one of your Community Cloud machines
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
CommunityApi	update_community_machine	PATCH /community/machines/{id}	Update a Community Cloud machine's price
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.2.5

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.2.5
File	Size	Uploaded
gpuai_sdk-0.2.5.tar.gz	94.1 kB	Aug 18, 2026	Details

Built distribution (wheel)

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

Total release size: 277.5 kB

Release files / gpuai_sdk-0.2.5.tar.gz

Download URL	gpuai_sdk-0.2.5.tar.gz
Size	94.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`75d27c8af387c371c9267307084718d43d47102cafebd11443d9bcd5c558d710`
BLAKE2b-256 checksum How to use checksums	`db02eca46e1675ca46d5a93946d0e509215bd49726098073daf36c279e703a16`
Upload date	Aug 18, 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/91453437d2f8f67df6ab6859fa70e823e5b847d6

Workflow

Publishing configuration: github.com/gpuai-dev/gpu-ai/blob/91453437d2f8f67df6ab6859fa70e823e5b847d6/.github/workflows/sdk-release.yml
Publishing logs: github.com/gpuai-dev/gpu-ai/actions/runs/32130915665/attempts/1

Artifact

Subject: gpuai_sdk-0.2.5.tar.gz
SHA-256 checksum: 75d27c8af387c371c9267307084718d43d47102cafebd11443d9bcd5c558d710 Verifying attestations

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

Download URL	gpuai_sdk-0.2.5-py3-none-any.whl
Size	183.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`64e378dfe7eef4b8d5e01be5abc8d0c9bfefc9c991c3cb6ea9286a80194e738f`
BLAKE2b-256 checksum How to use checksums	`0fd257f966b3e65556bd10e5b158da13c5e06317435ea63444f64e5460e78bf8`
Upload date	Aug 18, 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/91453437d2f8f67df6ab6859fa70e823e5b847d6

Workflow

Publishing configuration: github.com/gpuai-dev/gpu-ai/blob/91453437d2f8f67df6ab6859fa70e823e5b847d6/.github/workflows/sdk-release.yml
Publishing logs: github.com/gpuai-dev/gpu-ai/actions/runs/32130915665/attempts/1

Artifact

Subject: gpuai_sdk-0.2.5-py3-none-any.whl
SHA-256 checksum: 64e378dfe7eef4b8d5e01be5abc8d0c9bfefc9c991c3cb6ea9286a80194e738f Verifying attestations