API Quickstart - DeployGPU

Prerequisites

A DeployGPU account with credits
An API key (create one in Settings > API Keys on the dashboard)

1. Browse Offers

Find a GPU that fits your needs:

curl https://api.deploygpu.ai/api/v1/offers?gpu=a100-sxm-80gb&size=5

Note the id of the offer you want.

2. Pick an OS Image

List available images for the offer’s provider:

curl https://api.deploygpu.ai/api/v1/providers/verda/images

Note the id of the image you want (e.g., ubuntu-22.04-cuda-12.4-docker).

3. Deploy

curl -X POST https://api.deploygpu.ai/api/v1/deployments \
  -H "Authorization: Bearer gpu_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "verda",
    "offer_id": "OFFER_ID_HERE",
    "os_image_id": "ubuntu-22.04-cuda-12.4-docker",
    "disk_gb": 100
  }'

You’ll get back:

{
  "id": "a6305686-fe03-494c-b254-9ee0a2453068",
  "status": "provisioning"
}

4. Wait for Active

Poll until the status changes to active (typically 1–3 minutes):

curl https://api.deploygpu.ai/api/v1/deployments/DEPLOYMENT_ID \
  -H "Authorization: Bearer gpu_live_YOUR_KEY"

Once active, the response includes connection details:

{
  "status": "active",
  "connection": {
    "public_ip": "135.181.63.213",
    "ssh_port": 22,
    "ssh_user": "root"
  }
}

5. Connect via SSH

ssh root@135.181.63.213

Your SSH keys are automatically injected. If you haven’t added any, your default key (generated at signup) is used.

6. Stop When Done

curl -X POST https://api.deploygpu.ai/api/v1/deployments/DEPLOYMENT_ID/stop \
  -H "Authorization: Bearer gpu_live_YOUR_KEY"

Billing stops once the instance is terminated.

​Prerequisites

​1. Browse Offers

​2. Pick an OS Image

​3. Deploy

​4. Wait for Active

​5. Connect via SSH

​6. Stop When Done