Skip to main content
POST
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.

Body

application/json

Pre-submission eligibility preview request. Mirrors the job form's accelerator block: type, count, and optional ordered fallback types.

accelerator
AcceleratorSpec · object
required

A hardware accelerator request — GPU, NPU, TPU, or similar.

Request an accelerator by type and count, with optional fallback types.

Response

Successful Response

Provider-anonymous capacity preview: counts, price bands, and advice only. Configurations, providers, regions, and SKUs are never enumerated.

acquirability
enum<string>
required

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_now
integer
required

Matching configurations that could start immediately.

advice
string[]
required

Machine-generated, provider-anonymous guidance.

eligible
boolean
required

Whether any known configuration matches the request.

est_start
enum<string>
required

Coarse expected-start band for the request as the market looks now.

Available options:
immediate,
minutes,
queued,
unknown
watchable
integer
required

Known matching configurations currently out of stock.

price_usd_hr
EligibilityPriceBand · object

USD-per-hour price band across the configurations matching an eligibility request.