Providers - DeployGPU

These endpoints are public and do not require authentication.

List Providers

GET /api/v1/providers

Returns all available GPU providers.

Response

{
  "data": [
    { "name": "hyperstack", "type": "vm" },
    { "name": "latitude", "type": "vm" },
    { "name": "masscompute", "type": "vm" },
    { "name": "vastai", "type": "container" },
    { "name": "verda", "type": "vm" }
  ]
}

Type	Description
`vm`	Virtual machine providers. Deploy with an OS image. Supported via API.
`container`	Container providers. Deploy with Docker images. Dashboard only.

List OS Images

GET /api/v1/providers/{provider}/images

Returns available OS images for a VM provider. Use the id field as os_image_id when creating a deployment. The provider must appear in GET /api/v1/providers; otherwise this endpoint returns 503 provider_unavailable without calling its external API. Results are cached for 1 hour.

Query Parameters

Param	Type	Description
`instance_type`	string	Optional — filter images available for a specific instance type

Response

{
  "data": [
    {
      "id": "ubuntu-22.04-cuda-12.4-docker",
      "displayName": "Ubuntu 22.04 + CUDA 12.4 + Docker",
      "slug": "ubuntu-22.04-cuda-12.4-docker",
      "hasCuda": true,
      "cudaVersion": "12.4",
      "hasDocker": true,
      "isDefault": false
    }
  ]
}

Field	Description
`id`	Image identifier — pass this as `os_image_id`
`displayName`	Human-readable name
`hasCuda`	Whether CUDA drivers are pre-installed
`cudaVersion`	CUDA version if installed (e.g., `"12.4"`)
`hasDocker`	Whether Docker is pre-installed
`isDefault`	Whether this is the provider’s default image

List Volume Types

GET /api/v1/providers/{provider}/volume-types

Returns available volume types for providers that support persistent storage. Use these values as volume_type when creating a volume. The provider must appear in GET /api/v1/providers; otherwise this endpoint returns 503 provider_unavailable without calling its external API. Results are cached for 1 hour.

Response

{
  "data": ["Cloud-SSD"]
}

Not all providers support volumes. If a provider doesn’t, this returns an empty list.