Skip to main content
POST
Request a price quote

Authorizations

Authorization
string
header
required

Your AI Reserve API key (aireserve_api_…) from the API Keys page in the portal (https://portal.aireserve.com/keys).

Body

application/json

Candidate spec to price. Include gpuTypeId, gpuCount, containerDiskGb, and dataCenterId for pods; sizeGb and dataCenterId for volumes.

kind
enum<string>

Resource kind. Inferred from field presence when omitted.

Available options:
pod,
volume
gpuTypeId
string
gpuCount
integer
containerDiskGb
integer
dataCenterId
string
sizeGb
integer

Volume size in GiB (for kind: volume).

Response

Price quote. Pass quoteId in the create/grow mutation.

A signed, time-limited price quote for a pod or volume. Pass quoteId in the subsequent create/grow mutation. Expires after 2 minutes.

id
string
required

Signed quote token — same as quoteId.

quoteId
string
required

Signed quote token. Alias for id. Pass this value as quoteId in the create/grow request.

kind
enum<string>
required
Available options:
pod,
volume
hourlyRateUsd
string
required

Total hourly charge in USD, six-decimal precision.

expiresAt
string<date-time>
required

Quote expiry. Submit the mutation before this time or request a fresh quote.

spec
object

Hardware parameters the quote binds (GPU type, count, disk, data center for pods; sizeGb, data center for volumes).

computeUsdPerHour
string

GPU + container disk portion of the hourly rate.

storageUsdPerHour
string

Storage portion of the hourly rate (non-zero for volume quotes).