Catalogue
List hardware presets
Returns a cursor-paginated list of the hardware configurations instances can run on, with their hourly price.
A preset fixes the GPU model and count, CPU, memory and storage. The
same preset may be offered in several regions at different prices, so
filter by region when comparing.
GET
/
presets
List hardware presets
curl --request GET \
--url https://api.hivecompute.ai/v1/presets \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.hivecompute.ai/v1/presets', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.hivecompute.ai/v1/presets"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"id": "<string>",
"region": "FR",
"location": "<string>",
"gpu": "8×",
"cpu": "32",
"memory": "192",
"storage": "500",
"hourly_price": "3.2000",
"price_discounted": "2.8000"
}
],
"pagination": {
"next": "eyJjcmVhdGVkX2F0IjoiMjAyNi0wNy0yOSJ9",
"size": 50
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "[{\"property\":\"size\",\"constraints\":[\"size must not be greater than 200\"]}]",
"request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "Missing API token",
"request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
}{
"error": {
"code": "TOO_MANY_REQUESTS",
"message": "Too Many Requests",
"request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
}{
"error": {
"code": "INTERNAL_ERROR",
"message": "An internal error occurred.",
"request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
}Authorizations
Query Parameters
Return only presets available in this region. Use a name from
GET /regions.
Unlike the filter on GET /instances, this one also matches a raw
datacenter location name, but only for locations that have no region
mapping. Any other unrecognised value matches nothing and returns an
empty page rather than an error.
Available options:
UAE, FR, US Was this page helpful?
⌘I
List hardware presets
curl --request GET \
--url https://api.hivecompute.ai/v1/presets \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.hivecompute.ai/v1/presets', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.hivecompute.ai/v1/presets"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"id": "<string>",
"region": "FR",
"location": "<string>",
"gpu": "8×",
"cpu": "32",
"memory": "192",
"storage": "500",
"hourly_price": "3.2000",
"price_discounted": "2.8000"
}
],
"pagination": {
"next": "eyJjcmVhdGVkX2F0IjoiMjAyNi0wNy0yOSJ9",
"size": 50
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "[{\"property\":\"size\",\"constraints\":[\"size must not be greater than 200\"]}]",
"request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "Missing API token",
"request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
}{
"error": {
"code": "TOO_MANY_REQUESTS",
"message": "Too Many Requests",
"request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
}{
"error": {
"code": "INTERNAL_ERROR",
"message": "An internal error occurred.",
"request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
}