Sesterce Cloud Doc
  • 👋Welcome on Sesterce Cloud
    • 🚀Get Started!
      • Account creation
      • Manage your account
      • Payment & Billing
        • Invoicing
  • 🚀Compute instances
    • Compute Instance configuration
      • Persistent storage (volumes)
      • SSH Keys
    • Terminal connection
  • 💬AI Inference instances
    • Inference Instance configuration
      • Select your Flavor
      • Select your regions
      • Autoscaling limits
    • Edit an inference instance
    • Chat with Endpoint
  • ▶️Manage your instances
  • 🔗API Reference
    • Authentication
    • GPU Cloud instances
    • SSH Keys
    • Volumes
    • Inference Instances
  • 📗Tutorials
    • Expose AI model from Hugging Face using vLLM
Powered by GitBook
On this page

Was this helpful?

  1. API Reference

GPU Cloud instances

The following endpoints allow to create and manage GPU Cloud instances from the API.

PreviousAuthenticationNextSSH Keys

Last updated 5 months ago

Was this helpful?

Get the list of available offers

Use this endpoint when you want to explore the different GPU instance options available for your project. This is particularly useful when planning new deployments and needing to compare offers to find the best fit in terms of cost and performance.

Double-check all inputs in the request body to ensure successful creation.

Create a GPU Cloud instance

Use this endpoint when you're ready to launch a new GPU instance for a specific project or task. This is the crucial step to deploy new computing resources.

You can use query parameters to fine-tune search results and find the best offer for your specific needs

Get the list of instances created

This endpoint is essential for users who want an overview of all the instances they have created. It is ideal for managing and monitoring current resources.

Ensure your API key is active and correctly entered to view your instances.

Get details about a GPU Cloud instance created

This endpoint is useful when you need to check the details and status of a specific instance, for example, for troubleshooting or configuration verification.

Use the instance ID from your list to quickly retrieve detailed information.

Delete a GPU Cloud instance

Use this endpoint when you want to free up resources by deleting an instance that is no longer needed, optimizing your resource usage and costs.

If needed, ensure data backup before deleting instances to prevent data loss. Discover how to create persistent storage .

🔗
through the following endpoint
get
Query parameters
cloudProviderstringOptional
regionstringOptional
numGpusstringOptional
gpustringOptional
availablebooleanOptional
sortstring · enumOptionalPossible values:
Header parameters
x-api-keystringRequired

The API Key secret should be sent through this header to authenticate the request.

Responses
200
Returns the list of available offers for instances
application/json
403
API key invalid
application/json
404
Not found
application/json
get
GET /gpu-cloud/instances/offers HTTP/1.1
Host: 
x-api-key: text
Accept: */*
[
  {
    "id": "A6000x8",
    "cloudProvider": {
      "_id": "668f9d8df664e3c028ce5de9",
      "displayName": "SESTERCE_IMW"
    },
    "configuration": {
      "memoryInGb": 100,
      "storageInGb": 1000,
      "vcpus": 100,
      "numGpus": 10,
      "gpuType": "A6000",
      "interconnect": "pcie",
      "vramPerGpuInGb": 100,
      "osOptions": "ubuntu22.04_cuda12.2_shade_os"
    },
    "hourlyPrice": 100,
    "availability": [
      {
        "region": "us-central-2",
        "displayName": "US, Central",
        "available": true
      }
    ],
    "bootTime": {
      "minBootInSec": 300,
      "maxBootInSec": 600
    }
  }
]
get
Header parameters
x-api-keystringRequired

The API Key secret should be sent through this header to authenticate the request.

Responses
200
Returns the list of user instances
application/json
403
API key invalid
application/json
404
API key not found
application/json
get
GET /gpu-cloud/instances HTTP/1.1
Host: 
x-api-key: text
Accept: */*
[
  {
    "_id": "668f9d8df664e3c028ce5de9",
    "user": "668f9d8df664e3c028ce5de9",
    "name": "my-machine-name",
    "region": "us-central-2",
    "volumes": [
      "668f9d8df664e3c028ce5de9"
    ],
    "isPending": true,
    "createdAt": "2023-08-08T12:34:56.789Z",
    "updatedAt": "2023-08-08T12:34:56.789Z"
  }
]
get
Path parameters
idstringRequired
Header parameters
x-api-keystringRequired

The API Key secret should be sent through this header to authenticate the request.

Responses
200
Return the instance's details
application/json
403
API key invalid
application/json
404
Not found
application/json
get
GET /gpu-cloud/instances/{id} HTTP/1.1
Host: 
x-api-key: text
Accept: */*
{
  "_id": "668f9d8df664e3c028ce5de9",
  "user": "668f9d8df664e3c028ce5de9",
  "name": "my-machine-name",
  "region": "us-central-2",
  "volumes": [
    "668f9d8df664e3c028ce5de9"
  ],
  "configuration": {
    "memoryInGb": 10,
    "storageInGb": 10,
    "vcpus": 10,
    "numGpus": 10,
    "gpuType": "A6000",
    "interconnect": "pcie",
    "nvlink": false,
    "os": "ubuntu22.04_cuda12.2_shade_os",
    "vramPerGpuInGb": 10
  },
  "ip": "127.0.0.1",
  "sshKey": {
    "_id": "668f9d8df664e3c028ce5de9",
    "user": "668f9d8df664e3c028ce5de9",
    "name": "ssh-key-name",
    "publicKey": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQDHRbO3HkzPmp65PR...fAn7Jlb8b61BFh6k= cloud@sesterce",
    "isDefault": false,
    "createdAt": "2024-10-16T16:05:11.439Z",
    "updatedAt": "2024-11-15T12:46:12.327Z"
  },
  "sshUser": "sesterce",
  "sshPort": 22,
  "status": "pending",
  "costEstimate": "0",
  "hourlyPrice": 10,
  "createdAt": "2024-11-15T12:40:44.023Z",
  "updatedAt": "2024-11-15T12:40:44.051Z"
}
delete
Path parameters
idstringRequired
Header parameters
x-api-keystringRequired

The API Key secret should be sent through this header to authenticate the request.

Responses
204
Instance deleted successfully
403
API key invalid
application/json
404
Not found
application/json
delete
DELETE /gpu-cloud/instances/{id} HTTP/1.1
Host: 
x-api-key: text
Accept: */*

No content

  • Get the list of available offers
  • GET/gpu-cloud/instances/offers
  • Create a GPU Cloud instance
  • POST/gpu-cloud/instances
  • Get the list of instances created
  • GET/gpu-cloud/instances
  • Get details about a GPU Cloud instance created
  • GET/gpu-cloud/instances/{id}
  • Delete a GPU Cloud instance
  • DELETE/gpu-cloud/instances/{id}
post
Header parameters
x-api-keystringRequired

The API Key secret should be sent through this header to authenticate the request.

Body
namestringRequired
cloudProviderstringRequiredExample: cloudProviderId
instanceOfferstringRequiredExample: instanceOfferId
regionstringRequiredExample: regionId
sshKeystringOptional
Responses
201
Return the created instance
application/json
403
API key invalid
application/json
404
Not found
application/json
post
POST /gpu-cloud/instances HTTP/1.1
Host: 
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 396

{
  "name": "my-machine-name",
  "cloudProvider": "670fe43738c181c96d19091e",
  "instanceOffer": "670fe43738c181c96d19091e",
  "region": "MON1",
  "vm": {
    "os": "ubuntu22.04_cuda12.2_shade_os",
    "base64StartupScript": "IyEvYmluL2Jhc2gKCiMgRW5kbGVzcyBsb29wCndoaWxlIHRydWUKZG8KICAgICMgRmV0Y2ggYSBjYXQgZmFjdCB3aXRoIG...",
    "volumes": [
      "670fe43738c181c96d19091e",
      "670fe43738c181c96d19091f"
    ]
  },
  "sshKey": "670fe43738c181c96d19091e"
}
{
  "_id": "668f9d8df664e3c028ce5de9",
  "user": "668f9d8df664e3c028ce5de9",
  "name": "my-machine-name",
  "region": "us-central-2",
  "volumes": [
    "668f9d8df664e3c028ce5de9"
  ],
  "isPending": true,
  "createdAt": "2023-08-08T12:34:56.789Z",
  "updatedAt": "2023-08-08T12:34:56.789Z"
}