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
Any of:
string

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
Data

List of available instances

Array<object>
Instance

A single GPU instance type.

object
id
required
Id

Instance type ID (use this when creating finetune jobs)

string
name
required
Name

Instance flavor name

string
description
required
Description

Instance description

string
gpu_description
required
Gpu Description

Clean GPU description

string
credits_per_hour
required
Credits Per Hour

Cost in credits per hour

integer
specs
required
InstanceSpecs

Hardware specifications

object
vcpus
required
Vcpus

Number of virtual CPUs

integer
memory_gib
required
Memory Gib

Memory in GiB

integer
storage_gib
required
Storage Gib

Storage in GiB

integer
gpu_count
required
Gpu Count

Number of GPUs

integer
gpu_type
required
Gpu Type

GPU model name

string
regions
required
Regions

Available regions

Array<object>
InstanceRegion

A region where an instance is available.

object
name
required
Name

Region identifier

string
description
required
Description

Human-readable region name

string
region_count
required
Region Count

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
Detail

Error message describing what went wrong

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

422

Section titled “422 ”

Validation Error

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