Skip to content
Qualia Docs

List GPU Instances

GET
/v1/instances
 
curl --request GET \
  --url https://example.com/v1/instances

List available GPU instances and pricing.

Returns a list of available GPU instance types with their hourly rates. Use the instance ID when creating a finetune job to specify the GPU type.

Parameters

Section titled “ Parameters ”

Header Parameters

Section titled “Header Parameters ”
x-api-key
string | null

Responses

Section titled “ Responses ”

200

Section titled “200 ”

List of available GPU instances with pricing

Media type application/json
InstancesListResponse

Response containing available GPU instances.

object
data
required

List of available instances

Array<object>
Instance

A single GPU instance type.

object
id
required

Instance type ID (use this when creating finetune jobs)

string
name
required

Instance flavor name

string
description
required

Instance description

string
gpu_description
required

Clean GPU description

string
credits_per_hour
required

Cost in credits per hour

integer
specs
required
InstanceSpecs

Hardware specifications

object
vcpus
required

Number of virtual CPUs

integer
memory_gib
required

Memory in GiB

integer
storage_gib
required

Storage in GiB

integer
gpu_count
required

Number of GPUs

integer
gpu_type
required

GPU model name

string
regions
required

Available regions

Array<object>
InstanceRegion

A region where an instance is available.

object
name
required

Region identifier

string
description
required

Human-readable region name

string
region_count
required

Number of available regions

integer
Example generated
{
  "data": [
    {
      "id": "example",
      "name": "example",
      "description": "example",
      "gpu_description": "example",
      "credits_per_hour": 1,
      "specs": {
        "vcpus": 1,
        "memory_gib": 1,
        "storage_gib": 1,
        "gpu_count": 1,
        "gpu_type": "example"
      },
      "regions": [
        {
          "name": "example",
          "description": "example"
        }
      ],
      "region_count": 1
    }
  ]
}

401

Section titled “401 ”

Invalid or missing API key

Media type application/json
ErrorResponse

Standard error response.

object
detail
required

Error message describing what went wrong

string
Example generated
{
  "detail": "example"
}

422

Section titled “422 ”

Validation Error

Media type application/json
HTTPValidationError
object
detail
Array<object>
ValidationError
object
loc
required
Location
Array<string | integer>
msg
required
Message
string
type
required
Error Type
string
Example generated
{
  "detail": [
    {
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}