Preview accelerator eligibility
Preview, before submitting a job or deployment, how much matching capacity the cluster can currently acquire and how likely it is to start. The response is provider-anonymous: counts, price bands, and advice only. This is an advisory read; it reserves nothing.
Authorizations
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
Optional external end-user identifier forwarded by the API gateway.
Body
Pre-submission eligibility preview request. Mirrors the job form's accelerator block: type, count, and optional ordered fallback types.
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.
Banded estimate of how reliably matching capacity can be acquired, computed from availability history. "unknown" means no history, never a guess.
high, medium, low, unknown Matching configurations that could start immediately.
Machine-generated, provider-anonymous guidance.
Whether any known configuration matches the request.
Coarse expected-start band for the request as the market looks now.
immediate, minutes, queued, unknown Known matching configurations currently out of stock.
USD-per-hour price band across the configurations matching an eligibility request.