Rent GPU

NetMind Power Documentation

List Machines

get

/v1/rentgpu/machines

Query parameters

currencystring · enum · default: USD

Options: USD, CNY

regionstring

Enumeration types supported: 'HK', 'SE', 'CZ', 'CA', 'RO', 'US', 'ES', 'BR', 'CN', 'JP', 'DE', 'AU', 'IT', 'RU', 'PL', 'VN', 'PH', 'TW', 'NL', 'RS', 'SG', 'AR', 'NZ', 'FI', 'IN', 'BG', 'NO', 'EE', 'MY', 'BH', 'GB', 'LT'

gpuinteger · default: 1

Comma-separated GPU types. Supported types are: 'NVIDIA_GeForce_RTX_3090', 'NVIDIA_GeForce_RTX_3090_Ti', 'NVIDIA_GeForce_RTX_4090', 'NVIDIA_A100_SXM4_80GB', 'NVIDIA_H100_SXM5_80GB', 'NVIDIA_A100_80GB_PCIe', 'NVIDIA_A100_PCIE_80GB', 'NVIDIA_ A800_PCIe_40GB', 'NVIDIA_A100_SXM4_40GB', 'NVIDIA_A100_PCIE_40GB', 'NVIDIA_GeForce_RTX_A6000', 'NVIDIA_Quadro_RTX_8000', 'NVIDIA_GeForce_RTX_4080', 'Tesla_V100_PCIE_32GB', 'Tesla_V100_SXM2_32GB', 'NVIDIA_Quadro_RTX_6000', 'NVIDIA_GeForce_RTX_3080', 'NVIDIA_GeForce_RTX_4070_Ti', 'Tesla_V100_PCIE_16GB', 'TITAN_RTX', 'Tesla_V100_SXM2_16GB', 'NVIDIA_GeForce_RTX_3070', 'TITAN_V', 'NVIDIA_GeForce_RTX_4060_Ti', 'NVIDIA_GeForce_RTX_2080_SUPER', 'NVIDIA_GeForce_RTX_2080_Ti', 'NVIDIA_GeForce_RTX_4060', 'NVIDIA_GeForce_RTX_2080', 'TITAN_Xp', 'NVIDIA_GeForce_RTX_2070_SUPER', 'NVIDIA_GeForce_GTX_1080_Ti', 'NVIDIA_GeForce_RTX_3060', 'TITAN_X_Pascal', 'NVIDIA_GeForce_RTX_2060_SUPER', 'NVIDIA_GeForce_RTX_2070', 'NVIDIA_GeForce_GTX_1070_Ti', 'NVIDIA_GeForce_RTX_3060_Laptop_GPU', 'NVIDIA_GeForce_GTX_1080', 'NVIDIA_GeForce_GTX_1070', 'NVIDIA_GeForce_GTX_1660_Ti', 'NVIDIA_GeForce_GTX_1060_6GB', 'Tesla_M60', 'NVIDIA_RTX_6000_Ada_Generation'.

gpu_namesstring

min_memoryinteger

max_memoryinteger

min_diskinteger

max_diskinteger

min_priceinteger

max_priceinteger

Header parameters

Authorizationstringrequired

Your API token

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.netmind.ai/v1/rentgpu/machines' \
  --header 'Authorization: text'

200

422

[
  {
    "on_demand": "text",
    "node_name": "text",
    "cluster": "text",
    "gpu_name": "text",
    "gpu_count": 1,
    "gpu_memory": 1,
    "cpu_name": "text",
    "cpu_count": 1,
    "cpu_per_gpu": 1,
    "memory_per_gpu": 1,
    "memory_total": 1,
    "disk_per_gpu": 1,
    "disk_total": 1,
    "region": "text",
    "network_upload_speed": 1,
    "network_download_speed": 1,
    "up_time": 1,
    "online_rate": 1,
    "price": "text",
    "original_price": "text",
    "gpu_id": 1,
    "labels": [
      "text"
    ],
    "organization": "text",
    "driver_version": "text",
    "cuda_version": "text",
    "nvlink_status": true
  }
]

Successful Response

Create Auth

post

/v1/rentgpu/auths/

Header parameters

Authorizationstringrequired

Your API token

Body

valuestring · min: 8 · max: 32required

The password of your SSH container.

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://api.netmind.ai/v1/rentgpu/auths/' \
  --header 'Authorization: text' \
  --header 'Content-Type: application/json' \
  --data '{
    "value": "text"
  }'

200

422

{
  "id": 1,
  "value": "text",
  "created_at": "2025-02-28T07:10:08.740Z"
}

Successful Response

Get Auth List

get

/v1/rentgpu/auths/

Query parameters

markerinteger

The marker of the last auth you got, not specified if you want to get the first page.

limitinteger · default: 10

The number of auths you want to get.

Header parameters

Authorizationstringrequired

Your API token

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.netmind.ai/v1/rentgpu/auths/' \
  --header 'Authorization: text'

200

422

[
  {
    "id": 1,
    "value": "text",
    "created_at": "2025-02-28T07:10:08.740Z"
  }
]

Successful Response

Get Auth

get

/v1/rentgpu/auths/{auth_id}

Path parameters

auth_idintegerrequired

The ID of the container authorization you want to get.

Header parameters

Authorizationstringrequired

Your API token

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.netmind.ai/v1/rentgpu/auths/{auth_id}' \
  --header 'Authorization: text'

200

422

{
  "id": 1,
  "value": "text",
  "created_at": "2025-02-28T07:10:08.740Z"
}

Successful Response

Create Custom Image

post

/v1/rentgpu/images/

Header parameters

Authorizationstringrequired

Your API token

Body

namestringrequired

The name of the image

descriptionstring

The description of the image

image_namestringrequired

The name of the image, such as pytorch/pytorch or tensorflow/tensorflow.

image_tagstringrequired

The version of the image, such as 1.8.0, 2.6.0 or latest.

image_labelstringrequired

The label of the image, such as pytorch, tensorflow or unbuntu.

docker_usernamestring

The username of the docker registry if it is private

docker_passwdstring

The password of the docker registry if it is private

docker_registrystring · default: https://index.docker.io/v1/

The docker registry if it is private, the default is https://index.docker.io/v1/

public_portstring

Public port you want to expose from this container, it's optional

onstartstring

The command you want to run when the container starts, it is not required

optionsstring

The options you want to pass to the container, only support --add-host, -e, -h, -w, it is not required

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://api.netmind.ai/v1/rentgpu/images/' \
  --header 'Authorization: text' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "text",
    "description": "text",
    "image_name": "text",
    "image_tag": "text",
    "image_label": "text",
    "docker_username": "text",
    "docker_passwd": "text",
    "docker_registry": "https://index.docker.io/v1/",
    "public_port": "text",
    "onstart": "text",
    "options": "text"
  }'

200

422

{
  "name": "text",
  "description": "text",
  "image_name": "text",
  "image_tag": "text",
  "image_label": "text",
  "docker_username": "text",
  "docker_passwd": "text",
  "docker_registry": "https://index.docker.io/v1/",
  "public_port": "text",
  "onstart": "text",
  "options": "text",
  "id": 1,
  "created_at": "2025-02-28T07:10:08.740Z",
  "image_type": 2
}

Successful Response

Get Image List

get

/v1/rentgpu/images/

Query parameters

image_typeall of · default: 0

Image type you want to filter, the value can be OFFICIAL, PUBLIC, CUSTOM, default is OFFICIAL

An enumeration.

markerstring

The marker id of the image you got, used for pagination

limitinteger · default: 10

The number of images you want to get, default is 10

Header parameters

Authorizationstringrequired

Your API token

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.netmind.ai/v1/rentgpu/images/' \
  --header 'Authorization: text'

200

422

[
  {
    "name": "text",
    "description": "text",
    "image_name": "text",
    "image_tag": "text",
    "image_label": "text",
    "docker_username": "text",
    "docker_passwd": "text",
    "docker_registry": "https://index.docker.io/v1/",
    "public_port": "text",
    "onstart": "text",
    "options": "text",
    "id": 1,
    "created_at": "2025-02-28T07:10:08.740Z",
    "image_type": 2
  }
]

Successful Response

Get Image

get

/v1/rentgpu/images/{image_id}

Path parameters

image_idintegerrequired

The id of the image you want to get

Header parameters

Authorizationstringrequired

Your API token

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.netmind.ai/v1/rentgpu/images/{image_id}' \
  --header 'Authorization: text'

200

422

{
  "name": "text",
  "description": "text",
  "image_name": "text",
  "image_tag": "text",
  "image_label": "text",
  "docker_username": "text",
  "docker_passwd": "text",
  "docker_registry": "https://index.docker.io/v1/",
  "public_port": "text",
  "onstart": "text",
  "options": "text",
  "id": 1,
  "created_at": "2025-02-28T07:10:08.740Z",
  "image_type": 2
}

Successful Response

Create Container

post

/v1/rentgpu/containers/

Header parameters

Authorizationstringrequired

Your API token

Body

namestringrequired

Your container name.

auth_idintegerrequired

Auth id, You should create a container authorization first.

gpuinteger · max: 12 · default: 1required

GPU number you want to rent.

node_namestringrequired

Node name returned by the query machine interface.

image_template_idintegerrequired

You can choose an image template or create a new one.

payment_typeall ofrequired

Payment type, an enum value, you can choose USD, NMT or CNY, mean what currency is used from your balance deducting fees.

An enumeration.

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://api.netmind.ai/v1/rentgpu/containers/' \
  --header 'Authorization: text' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "text",
    "auth_id": 1,
    "gpu": 1,
    "node_name": "text",
    "image_template_id": 1,
    "payment_type": 0
  }'

200

422

{
  "name": "text",
  "auth_id": 1,
  "gpu": 1,
  "node_name": "text",
  "image_template_id": 1,
  "enable_vscode": false,
  "enable_jupyter": false,
  "cpu": 1,
  "disk_size": 200,
  "memory": 1,
  "gpu_name": 1,
  "id": 1,
  "ssh": "text",
  "exposed_service": "text",
  "vscode_service": "text",
  "jupyter_service": "text",
  "created_at": "2025-02-28T07:10:08.740Z",
  "status": 0
}

Successful Response

Get Container List

get

/v1/rentgpu/containers/

Query parameters

statusinteger · enum[]

An enumeration.

limitinteger · default: 10

The number of containers you want to get, default is 10

markerinteger

The marker of the last container id you got, not specified by default, you can use it to get the next page

Header parameters

Authorizationstringrequired

Your API token

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.netmind.ai/v1/rentgpu/containers/' \
  --header 'Authorization: text'

200

422

[
  {
    "name": "text",
    "auth_id": 1,
    "gpu": 1,
    "node_name": "text",
    "image_template_id": 1,
    "enable_vscode": false,
    "enable_jupyter": false,
    "cpu": 1,
    "disk_size": 200,
    "memory": 1,
    "gpu_name": 1,
    "id": 1,
    "ssh": "text",
    "exposed_service": "text",
    "vscode_service": "text",
    "jupyter_service": "text",
    "created_at": "2025-02-28T07:10:08.740Z",
    "status": 0
  }
]

Successful Response

Get Container

get

/v1/rentgpu/containers/{container_id}

Path parameters

container_idintegerrequired

Container id you want to get

Header parameters

Authorizationstringrequired

Your API token

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.netmind.ai/v1/rentgpu/containers/{container_id}' \
  --header 'Authorization: text'

200

422

{
  "name": "text",
  "auth_id": 1,
  "gpu": 1,
  "node_name": "text",
  "image_template_id": 1,
  "enable_vscode": false,
  "enable_jupyter": false,
  "cpu": 1,
  "disk_size": 200,
  "memory": 1,
  "gpu_name": 1,
  "id": 1,
  "ssh": "text",
  "exposed_service": "text",
  "vscode_service": "text",
  "jupyter_service": "text",
  "created_at": "2025-02-28T07:10:08.740Z",
  "status": 0
}

Successful Response

Stop Container

post

/v1/rentgpu/containers/{container_id}/stop

Path parameters

container_idintegerrequired

Container id you want to stop

Header parameters

Authorizationstringrequired

Your API token

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://api.netmind.ai/v1/rentgpu/containers/{container_id}/stop' \
  --header 'Authorization: text'

200

422

{
  "name": "text",
  "auth_id": 1,
  "gpu": 1,
  "node_name": "text",
  "image_template_id": 1,
  "enable_vscode": false,
  "enable_jupyter": false,
  "cpu": 1,
  "disk_size": 200,
  "memory": 1,
  "gpu_name": 1,
  "id": 1,
  "ssh": "text",
  "exposed_service": "text",
  "vscode_service": "text",
  "jupyter_service": "text",
  "created_at": "2025-02-28T07:10:08.740Z",
  "status": 0
}

Successful Response

Restart Container

post

/v1/rentgpu/containers/{container_id}/restart

Path parameters

container_idintegerrequired

Container id you want to restart

Header parameters

Authorizationstringrequired

Your API token

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://api.netmind.ai/v1/rentgpu/containers/{container_id}/restart' \
  --header 'Authorization: text'

200

422

{
  "name": "text",
  "auth_id": 1,
  "gpu": 1,
  "node_name": "text",
  "image_template_id": 1,
  "enable_vscode": false,
  "enable_jupyter": false,
  "cpu": 1,
  "disk_size": 200,
  "memory": 1,
  "gpu_name": 1,
  "id": 1,
  "ssh": "text",
  "exposed_service": "text",
  "vscode_service": "text",
  "jupyter_service": "text",
  "created_at": "2025-02-28T07:10:08.740Z",
  "status": 0
}

Successful Response

Delete Container

delete

/v1/rentgpu/containers/{container_id}

Path parameters

container_idintegerrequired

Container id you want to delete

Header parameters

Authorizationstringrequired

Your API token

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request DELETE \
  --url 'https://api.netmind.ai/v1/rentgpu/containers/{container_id}' \
  --header 'Authorization: text'

200

422

{
  "name": "text",
  "auth_id": 1,
  "gpu": 1,
  "node_name": "text",
  "image_template_id": 1,
  "enable_vscode": false,
  "enable_jupyter": false,
  "cpu": 1,
  "disk_size": 200,
  "memory": 1,
  "gpu_name": 1,
  "id": 1,
  "ssh": "text",
  "exposed_service": "text",
  "vscode_service": "text",
  "jupyter_service": "text",
  "created_at": "2025-02-28T07:10:08.740Z",
  "status": 0
}

Successful Response

Machine List

Authentication

Images (Environment Template)

Container (Running Environment)

Machine List

Authentication

Images (Environment Template)

Container (Running Environment)

List Machines

Create Auth

Get Auth List

Get Auth

Create Custom Image

Get Image List

Get Image

Create Container

Get Container List

Get Container

Stop Container

Restart Container

Delete Container