> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aireserve.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Request a price quote

> Validate a candidate pod or volume spec against live capacity and return a signed price quote. The returned `quoteId` must be included in the subsequent `POST /v1/gpu/pods` or `POST /v1/gpu/volumes` call to bind the price. Quotes expire after 2 minutes. No idempotency key is required — quotes are free and non-spending.



## OpenAPI

````yaml /api-reference/openapi.json post /v1/gpu/quotes
openapi: 3.0.3
info:
  title: AI Reserve Gateway API
  description: >-
    The AI Reserve API surface — OpenAI-compatible chat completions,
    Anthropic-compatible messages, Bedrock Converse, images, video, files,
    text-to-speech, realtime voice sessions, and GPU Compute pod/volume
    management — all behind one endpoint and one API key.
  version: 1.0.0
servers:
  - url: https://api.aireserve.com
security:
  - bearerAuth: []
paths:
  /v1/gpu/quotes:
    post:
      tags:
        - GPU Compute
      summary: Request a price quote
      description: >-
        Validate a candidate pod or volume spec against live capacity and return
        a signed price quote. The returned `quoteId` must be included in the
        subsequent `POST /v1/gpu/pods` or `POST /v1/gpu/volumes` call to bind
        the price. Quotes expire after 2 minutes. No idempotency key is required
        — quotes are free and non-spending.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              description: >-
                Candidate spec to price. Include `gpuTypeId`, `gpuCount`,
                `containerDiskGb`, and `dataCenterId` for pods; `sizeGb` and
                `dataCenterId` for volumes.
              properties:
                kind:
                  type: string
                  enum:
                    - pod
                    - volume
                  description: Resource kind. Inferred from field presence when omitted.
                gpuTypeId:
                  type: string
                gpuCount:
                  type: integer
                containerDiskGb:
                  type: integer
                dataCenterId:
                  type: string
                sizeGb:
                  type: integer
                  description: 'Volume size in GiB (for `kind: volume`).'
            example:
              gpuTypeId: NVIDIA_A40
              gpuCount: 1
              containerDiskGb: 20
              dataCenterId: EU-RO-1
      responses:
        '200':
          description: Price quote. Pass `quoteId` in the create/grow mutation.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ComputeQuote'
        '402':
          description: >-
            Organization has unpaid storage delinquency; resolve before
            requesting new compute commitments.
        '403':
          description: >-
            API key lacks compute access, or Compute is not enabled for your
            organization.
        '409':
          description: >-
            Selected capacity is unavailable or the price cannot be verified at
            this time.
components:
  schemas:
    ComputeQuote:
      type: object
      description: >-
        A signed, time-limited price quote for a pod or volume. Pass `quoteId`
        in the subsequent create/grow mutation. Expires after 2 minutes.
      required:
        - id
        - quoteId
        - kind
        - hourlyRateUsd
        - expiresAt
      properties:
        id:
          type: string
          description: Signed quote token — same as `quoteId`.
        quoteId:
          type: string
          description: >-
            Signed quote token. Alias for `id`. Pass this value as `quoteId` in
            the create/grow request.
        kind:
          type: string
          enum:
            - pod
            - volume
        spec:
          type: object
          description: >-
            Hardware parameters the quote binds (GPU type, count, disk, data
            center for pods; sizeGb, data center for volumes).
        hourlyRateUsd:
          type: string
          description: Total hourly charge in USD, six-decimal precision.
        computeUsdPerHour:
          type: string
          description: GPU + container disk portion of the hourly rate.
        storageUsdPerHour:
          type: string
          description: Storage portion of the hourly rate (non-zero for volume quotes).
        expiresAt:
          type: string
          format: date-time
          description: >-
            Quote expiry. Submit the mutation before this time or request a
            fresh quote.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Your AI Reserve API key (aireserve_api_…) from the API Keys page in the
        portal (https://portal.aireserve.com/keys).

````