Skip to main content
POST
Find cheaper machines

Authorizations

X-API-Key
string
header
required

API key with "bl_" prefix (e.g. "bl_<api_key>")

Query Parameters

persist
boolean

Save a price computed for a shape the catalogue does not list. Defaults to true; false returns the same recommendations without saving.

Body

application/json

Machine to improve on

include_metadata
boolean
instance
object
predicates
object
usage
object
workload_class
string

WorkloadClass selects which accelerator gates a compute recommendation applies: inference_single, inference_multi or training_distributed. Empty means inference_multi, which is what the recommender did before the classes existed. Disk requests do not carry one.

Response

The cheapest candidate per provider

cost_per_work_unit
number
cpu_class
string
pricing
object
savings
object
work_unit
string