Create bare metal GPU cluster

curl --request POST \
  --url https://api.gcore.com/cloud/v1/ai/clusters/gpu/{project_id}/{region_id} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "flavor": "bm3-ai-1xlarge-h100-80-8",
  "image_id": "f01fd9a0-9548-48ba-82dc-a8c8b2d6f2f1",
  "interfaces": [
    {
      "network_id": "024a29e9-b4b7-4c91-9a46-505be123d9f8",
      "subnet_id": "91200a6c-07e0-42aa-98da-32d1f6545ae7",
      "type": "subnet"
    }
  ],
  "name": "my-gpu-cluster",
  "instances_count": 1,
  "password": "<string>",
  "security_groups": [
    {
      "id": "ae74714c-c380-48b4-87f8-758d656cdad6"
    }
  ],
  "ssh_key_name": "my-ssh-key",
  "tags": {},
  "user_data": "<string>",
  "username": "<string>"
}
'

import requests

url = "https://api.gcore.com/cloud/v1/ai/clusters/gpu/{project_id}/{region_id}"

payload = {
    "flavor": "bm3-ai-1xlarge-h100-80-8",
    "image_id": "f01fd9a0-9548-48ba-82dc-a8c8b2d6f2f1",
    "interfaces": [
        {
            "network_id": "024a29e9-b4b7-4c91-9a46-505be123d9f8",
            "subnet_id": "91200a6c-07e0-42aa-98da-32d1f6545ae7",
            "type": "subnet"
        }
    ],
    "name": "my-gpu-cluster",
    "instances_count": 1,
    "password": "<string>",
    "security_groups": [{ "id": "ae74714c-c380-48b4-87f8-758d656cdad6" }],
    "ssh_key_name": "my-ssh-key",
    "tags": {},
    "user_data": "<string>",
    "username": "<string>"
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    flavor: 'bm3-ai-1xlarge-h100-80-8',
    image_id: 'f01fd9a0-9548-48ba-82dc-a8c8b2d6f2f1',
    interfaces: [
      {
        network_id: '024a29e9-b4b7-4c91-9a46-505be123d9f8',
        subnet_id: '91200a6c-07e0-42aa-98da-32d1f6545ae7',
        type: 'subnet'
      }
    ],
    name: 'my-gpu-cluster',
    instances_count: 1,
    password: '<string>',
    security_groups: [{id: 'ae74714c-c380-48b4-87f8-758d656cdad6'}],
    ssh_key_name: 'my-ssh-key',
    tags: {},
    user_data: '<string>',
    username: '<string>'
  })
};

fetch('https://api.gcore.com/cloud/v1/ai/clusters/gpu/{project_id}/{region_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.gcore.com/cloud/v1/ai/clusters/gpu/{project_id}/{region_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'flavor' => 'bm3-ai-1xlarge-h100-80-8',
    'image_id' => 'f01fd9a0-9548-48ba-82dc-a8c8b2d6f2f1',
    'interfaces' => [
        [
                'network_id' => '024a29e9-b4b7-4c91-9a46-505be123d9f8',
                'subnet_id' => '91200a6c-07e0-42aa-98da-32d1f6545ae7',
                'type' => 'subnet'
        ]
    ],
    'name' => 'my-gpu-cluster',
    'instances_count' => 1,
    'password' => '<string>',
    'security_groups' => [
        [
                'id' => 'ae74714c-c380-48b4-87f8-758d656cdad6'
        ]
    ],
    'ssh_key_name' => 'my-ssh-key',
    'tags' => [
        
    ],
    'user_data' => '<string>',
    'username' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.gcore.com/cloud/v1/ai/clusters/gpu/{project_id}/{region_id}"

	payload := strings.NewReader("{\n  \"flavor\": \"bm3-ai-1xlarge-h100-80-8\",\n  \"image_id\": \"f01fd9a0-9548-48ba-82dc-a8c8b2d6f2f1\",\n  \"interfaces\": [\n    {\n      \"network_id\": \"024a29e9-b4b7-4c91-9a46-505be123d9f8\",\n      \"subnet_id\": \"91200a6c-07e0-42aa-98da-32d1f6545ae7\",\n      \"type\": \"subnet\"\n    }\n  ],\n  \"name\": \"my-gpu-cluster\",\n  \"instances_count\": 1,\n  \"password\": \"<string>\",\n  \"security_groups\": [\n    {\n      \"id\": \"ae74714c-c380-48b4-87f8-758d656cdad6\"\n    }\n  ],\n  \"ssh_key_name\": \"my-ssh-key\",\n  \"tags\": {},\n  \"user_data\": \"<string>\",\n  \"username\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.gcore.com/cloud/v1/ai/clusters/gpu/{project_id}/{region_id}")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"flavor\": \"bm3-ai-1xlarge-h100-80-8\",\n  \"image_id\": \"f01fd9a0-9548-48ba-82dc-a8c8b2d6f2f1\",\n  \"interfaces\": [\n    {\n      \"network_id\": \"024a29e9-b4b7-4c91-9a46-505be123d9f8\",\n      \"subnet_id\": \"91200a6c-07e0-42aa-98da-32d1f6545ae7\",\n      \"type\": \"subnet\"\n    }\n  ],\n  \"name\": \"my-gpu-cluster\",\n  \"instances_count\": 1,\n  \"password\": \"<string>\",\n  \"security_groups\": [\n    {\n      \"id\": \"ae74714c-c380-48b4-87f8-758d656cdad6\"\n    }\n  ],\n  \"ssh_key_name\": \"my-ssh-key\",\n  \"tags\": {},\n  \"user_data\": \"<string>\",\n  \"username\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.gcore.com/cloud/v1/ai/clusters/gpu/{project_id}/{region_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"flavor\": \"bm3-ai-1xlarge-h100-80-8\",\n  \"image_id\": \"f01fd9a0-9548-48ba-82dc-a8c8b2d6f2f1\",\n  \"interfaces\": [\n    {\n      \"network_id\": \"024a29e9-b4b7-4c91-9a46-505be123d9f8\",\n      \"subnet_id\": \"91200a6c-07e0-42aa-98da-32d1f6545ae7\",\n      \"type\": \"subnet\"\n    }\n  ],\n  \"name\": \"my-gpu-cluster\",\n  \"instances_count\": 1,\n  \"password\": \"<string>\",\n  \"security_groups\": [\n    {\n      \"id\": \"ae74714c-c380-48b4-87f8-758d656cdad6\"\n    }\n  ],\n  \"ssh_key_name\": \"my-ssh-key\",\n  \"tags\": {},\n  \"user_data\": \"<string>\",\n  \"username\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "tasks": [
    "d478ae29-dedc-4869-82f0-96104425f565"
  ]
}

{
  "exception_class": "NotFoundError",
  "message": "keypair not found",
  "request_id": "4e3e63f3-4f2a-4720-bf18-2a1986531b87"
}

POST

cloud

clusters

gpu

{project_id}

{region_id}

Create bare metal GPU cluster

curl --request POST \
  --url https://api.gcore.com/cloud/v1/ai/clusters/gpu/{project_id}/{region_id} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "flavor": "bm3-ai-1xlarge-h100-80-8",
  "image_id": "f01fd9a0-9548-48ba-82dc-a8c8b2d6f2f1",
  "interfaces": [
    {
      "network_id": "024a29e9-b4b7-4c91-9a46-505be123d9f8",
      "subnet_id": "91200a6c-07e0-42aa-98da-32d1f6545ae7",
      "type": "subnet"
    }
  ],
  "name": "my-gpu-cluster",
  "instances_count": 1,
  "password": "<string>",
  "security_groups": [
    {
      "id": "ae74714c-c380-48b4-87f8-758d656cdad6"
    }
  ],
  "ssh_key_name": "my-ssh-key",
  "tags": {},
  "user_data": "<string>",
  "username": "<string>"
}
'

import requests

url = "https://api.gcore.com/cloud/v1/ai/clusters/gpu/{project_id}/{region_id}"

payload = {
    "flavor": "bm3-ai-1xlarge-h100-80-8",
    "image_id": "f01fd9a0-9548-48ba-82dc-a8c8b2d6f2f1",
    "interfaces": [
        {
            "network_id": "024a29e9-b4b7-4c91-9a46-505be123d9f8",
            "subnet_id": "91200a6c-07e0-42aa-98da-32d1f6545ae7",
            "type": "subnet"
        }
    ],
    "name": "my-gpu-cluster",
    "instances_count": 1,
    "password": "<string>",
    "security_groups": [{ "id": "ae74714c-c380-48b4-87f8-758d656cdad6" }],
    "ssh_key_name": "my-ssh-key",
    "tags": {},
    "user_data": "<string>",
    "username": "<string>"
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    flavor: 'bm3-ai-1xlarge-h100-80-8',
    image_id: 'f01fd9a0-9548-48ba-82dc-a8c8b2d6f2f1',
    interfaces: [
      {
        network_id: '024a29e9-b4b7-4c91-9a46-505be123d9f8',
        subnet_id: '91200a6c-07e0-42aa-98da-32d1f6545ae7',
        type: 'subnet'
      }
    ],
    name: 'my-gpu-cluster',
    instances_count: 1,
    password: '<string>',
    security_groups: [{id: 'ae74714c-c380-48b4-87f8-758d656cdad6'}],
    ssh_key_name: 'my-ssh-key',
    tags: {},
    user_data: '<string>',
    username: '<string>'
  })
};

fetch('https://api.gcore.com/cloud/v1/ai/clusters/gpu/{project_id}/{region_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.gcore.com/cloud/v1/ai/clusters/gpu/{project_id}/{region_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'flavor' => 'bm3-ai-1xlarge-h100-80-8',
    'image_id' => 'f01fd9a0-9548-48ba-82dc-a8c8b2d6f2f1',
    'interfaces' => [
        [
                'network_id' => '024a29e9-b4b7-4c91-9a46-505be123d9f8',
                'subnet_id' => '91200a6c-07e0-42aa-98da-32d1f6545ae7',
                'type' => 'subnet'
        ]
    ],
    'name' => 'my-gpu-cluster',
    'instances_count' => 1,
    'password' => '<string>',
    'security_groups' => [
        [
                'id' => 'ae74714c-c380-48b4-87f8-758d656cdad6'
        ]
    ],
    'ssh_key_name' => 'my-ssh-key',
    'tags' => [
        
    ],
    'user_data' => '<string>',
    'username' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.gcore.com/cloud/v1/ai/clusters/gpu/{project_id}/{region_id}"

	payload := strings.NewReader("{\n  \"flavor\": \"bm3-ai-1xlarge-h100-80-8\",\n  \"image_id\": \"f01fd9a0-9548-48ba-82dc-a8c8b2d6f2f1\",\n  \"interfaces\": [\n    {\n      \"network_id\": \"024a29e9-b4b7-4c91-9a46-505be123d9f8\",\n      \"subnet_id\": \"91200a6c-07e0-42aa-98da-32d1f6545ae7\",\n      \"type\": \"subnet\"\n    }\n  ],\n  \"name\": \"my-gpu-cluster\",\n  \"instances_count\": 1,\n  \"password\": \"<string>\",\n  \"security_groups\": [\n    {\n      \"id\": \"ae74714c-c380-48b4-87f8-758d656cdad6\"\n    }\n  ],\n  \"ssh_key_name\": \"my-ssh-key\",\n  \"tags\": {},\n  \"user_data\": \"<string>\",\n  \"username\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.gcore.com/cloud/v1/ai/clusters/gpu/{project_id}/{region_id}")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"flavor\": \"bm3-ai-1xlarge-h100-80-8\",\n  \"image_id\": \"f01fd9a0-9548-48ba-82dc-a8c8b2d6f2f1\",\n  \"interfaces\": [\n    {\n      \"network_id\": \"024a29e9-b4b7-4c91-9a46-505be123d9f8\",\n      \"subnet_id\": \"91200a6c-07e0-42aa-98da-32d1f6545ae7\",\n      \"type\": \"subnet\"\n    }\n  ],\n  \"name\": \"my-gpu-cluster\",\n  \"instances_count\": 1,\n  \"password\": \"<string>\",\n  \"security_groups\": [\n    {\n      \"id\": \"ae74714c-c380-48b4-87f8-758d656cdad6\"\n    }\n  ],\n  \"ssh_key_name\": \"my-ssh-key\",\n  \"tags\": {},\n  \"user_data\": \"<string>\",\n  \"username\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.gcore.com/cloud/v1/ai/clusters/gpu/{project_id}/{region_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"flavor\": \"bm3-ai-1xlarge-h100-80-8\",\n  \"image_id\": \"f01fd9a0-9548-48ba-82dc-a8c8b2d6f2f1\",\n  \"interfaces\": [\n    {\n      \"network_id\": \"024a29e9-b4b7-4c91-9a46-505be123d9f8\",\n      \"subnet_id\": \"91200a6c-07e0-42aa-98da-32d1f6545ae7\",\n      \"type\": \"subnet\"\n    }\n  ],\n  \"name\": \"my-gpu-cluster\",\n  \"instances_count\": 1,\n  \"password\": \"<string>\",\n  \"security_groups\": [\n    {\n      \"id\": \"ae74714c-c380-48b4-87f8-758d656cdad6\"\n    }\n  ],\n  \"ssh_key_name\": \"my-ssh-key\",\n  \"tags\": {},\n  \"user_data\": \"<string>\",\n  \"username\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "tasks": [
    "d478ae29-dedc-4869-82f0-96104425f565"
  ]
}

{
  "exception_class": "NotFoundError",
  "message": "keypair not found",
  "request_id": "4e3e63f3-4f2a-4720-bf18-2a1986531b87"
}

Authorizations

Authorization

string

header

required

API key for authentication. Make sure to include the word apikey, followed by a single space and then your token. Example: apikey 1234$abcdef

Path Parameters

project_id

integer

required

Project ID

region_id

integer

required

Region ID

Body

application/json

flavor

string

required

Flavor name

Example:

"bm3-ai-1xlarge-h100-80-8"

image_id

string<uuid4>

required

Image ID

Example:

"f01fd9a0-9548-48ba-82dc-a8c8b2d6f2f1"

interfaces

(CreateGPUClusterExternalInterfaceSerializer · object | CreateGPUClusterSubnetInterfaceSerializer · object | CreateGPUClusterAnySubnetInterfaceSerializer · object)[]

required

A list of network interfaces for the server. You can create one or more interfaces - private, public, or both.

Minimum array length: 1

CreateGPUClusterExternalInterfaceSerializer
CreateGPUClusterSubnetInterfaceSerializer
CreateGPUClusterAnySubnetInterfaceSerializer

Show child attributes

Example:

[
  {
    "network_id": "024a29e9-b4b7-4c91-9a46-505be123d9f8",
    "subnet_id": "91200a6c-07e0-42aa-98da-32d1f6545ae7",
    "type": "subnet"
  }
]

name

string

required

GPU Cluster name

Pattern: ^[a-zA-Z0-9][a-zA-Z 0-9._\-]{1,61}[a-zA-Z0-9._]$

Example:

"my-gpu-cluster"

instances_count

integer

default:1

Number of servers to create

Required range: x >= 1

Example:

1

password

string

A password for a bare metal server. This parameter is used to set a password for the "Admin" user on a Windows instance, a default user or a new user on a Linux instance

security_groups

MandatoryIdSchema schema · object[]

List of security group UUIDs. If omitted or an empty list, the default security group will be used.

Show child attributes

ssh_key_name

string

Specifies the name of the SSH keypair, created via the /v1/ssh_keys endpoint.

Example:

"my-ssh-key"

Response

created tasks for cluster creation

tasks

string[]

required

List of task IDs representing asynchronous operations. Use these IDs to monitor operation progress:

GET /v1/tasks/{task_id} - Check individual task status and details Poll task status until completion (FINISHED/ERROR) before proceeding with dependent operations.

Example:

["d478ae29-dedc-4869-82f0-96104425f565"]

Check GPU cluster quotas List GPU flavors

⌘I