Skip to main content
GET
Python (SDK)

Authorizations

Authorization
string
header
required

Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.

Headers

X-On-Behalf-Of
string

Optional external end-user identifier forwarded by the API gateway.

Path Parameters

name
string
required

Response

Successful Response

An offered accelerator type in the catalog.

class
enum<string>
required

Coarse accelerator class. npu/tpu are reserved for future catalog entries.

Available options:
gpu,
cpu
max_count
integer
required

Max accelerators of this type per replica. For class cpu the unit is vCPUs: the maximum rentable vCPU count per replica.

name
string
required
Example:

"H100"

placements
enum<string>[]
required

Placements where this accelerator exists. All catalog entries are external (marketplace-acquired) today; internal arrives with private-cluster inventory.

Available options:
internal,
external
vendor
string
required
Examples:

"nvidia"

"amd"

"intel"

"aws"

workload_affinity
AcceleratorWorkloadAffinity · object
required

Per-workload suitability ratings for an accelerator type, seeded from the training hardware matrix.

acquirability
enum<string>

Banded estimate of how reliably matching capacity can be acquired, computed from availability history. "unknown" means no history, never a guess.

Available options:
high,
medium,
low,
unknown
acquirable_count
integer

Configurations acquirable now (0 when offered is false). Absent when live market data is unavailable.

kind
enum<string>
default:gpu
deprecated

Deprecated: use class. Retained for SDK compatibility until the next breaking conventions pass.

Available options:
gpu,
npu,
tpu,
other
memory_gb
integer

Per-accelerator memory in GB. Absent for class cpu: CPU capacity is sized per request (min_vcpus/min_mem_gb), not by a fixed module.

offered
boolean

Whether any capacity acquirable right now matches this type. Absent when live market data is unavailable.

price_usd_hr
AcceleratorPriceBand · object

USD-per-hour price band across configurations acquirable now for an accelerator type.