Deployments
Deploy a GPU cluster
Deploy a new GPU cluster.
X-API-Key<token>
GPU API key (format: mk_...). Generate from the dashboard
or via POST /api-keys.
In: header
Header Parameters
Idempotency-Key?string
Unique key to prevent duplicate operations on retry
Request Body
application/json
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://gpu.huddleapis.com/api/v1/deployments/clusters" \ -H "Content-Type: application/json" \ -d '{ "cluster_type": "1H100.80S.30V", "image": "ubuntu-22.04-cuda-13.0-cluster", "hostname": "my-training-cluster", "description": "LLM fine-tuning job", "ssh_key_ids": [ "key-id-1" ], "location": "FIN-01", "os_volume": { "name": "os-disk", "size": 100 }, "volumes": [ { "name": "data-vol", "size": 1000, "type": "NVMe" } ] }'{
"code": "OK",
"data": {
"id": "string",
"provider_id": "string",
"resource_type": "cluster",
"hostname": "my-training-cluster",
"cluster_type": "1H100.80S.30V",
"image": "ubuntu-24.04-cuda-13.0-open-docker",
"os_name": "Ubuntu 24.04",
"location": "FIN-01",
"status": "running",
"ip": "95.216.229.232",
"ssh_user": "root",
"ssh_key_ids": [
"string"
],
"specs": {
"gpu_model": "H100",
"gpu_count": 1,
"gpu_vram_gb": 80,
"total_vram_gb": 80,
"vcpu_count": 30,
"ram_gb": 120,
"storage_gb": 0,
"price_per_hr": 2.29,
"currency": "USD"
},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
}
}{
"code": "BAD_REQUEST",
"error": "Missing required field: hostname"
}{
"code": "BAD_REQUEST",
"error": "Missing required field: hostname"
}{
"code": "BAD_REQUEST",
"error": "Missing required field: hostname"
}{
"code": "BAD_REQUEST",
"error": "Missing required field: hostname"
}