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

# Get Model Pricing

> Batch pricing read: a versioned, `pricingMode`-discriminated rate card per endpoint. Repeat the `endpoint` parameter for a batch (aliases may contain slashes, so endpoints are never comma-joined). Endpoints that resolve to no priceable model are reported under `notFound` instead of failing the batch.



## OpenAPI

````yaml /platform-openapi.json get /models/pricing
openapi: 3.1.0
info:
  title: ModelRunner Platform API
  version: 1.0.0
  description: >-
    Platform APIs: model catalog, search and collections; model pricing rate
    cards; the Serverless GPU catalog and deployment templates; file uploads and
    your asset library; account balance and usage; and webhook delivery
    management. Catalog reads are public; account-scoped routes authenticate
    with your API key (`Authorization: Key <MODELRUNNER_KEY>`). Request
    lifecycle endpoints (submit/status/result and the request list) live on the
    queue host — see the Queue API reference.
servers:
  - url: https://api.modelrunner.run
security: []
paths:
  /models/pricing:
    get:
      summary: Get Model Pricing
      description: >-
        Batch pricing read: a versioned, `pricingMode`-discriminated rate card
        per endpoint. Repeat the `endpoint` parameter for a batch (aliases may
        contain slashes, so endpoints are never comma-joined). Endpoints that
        resolve to no priceable model are reported under `notFound` instead of
        failing the batch.
      parameters:
        - name: endpoint
          in: query
          required: true
          style: form
          explode: true
          schema:
            type: array
            items:
              type: string
            maxItems: 50
          description: '`ownerName/alias`, repeated. At most 50 per request.'
      responses:
        '200':
          description: Rate cards for the resolved endpoints.
          content:
            application/json:
              schema:
                type: object
                properties:
                  version:
                    const: 1
                  prices:
                    type: array
                    items:
                      $ref: '#/components/schemas/ModelPricingEntry'
                  notFound:
                    type: array
                    items:
                      type: string
        '400':
          description: No `endpoint` parameter, or more than 50.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    ModelPricingEntry:
      type: object
      properties:
        endpoint:
          type: string
          description: '`ownerName/alias`, echoed as requested.'
        rateCard:
          $ref: '#/components/schemas/ModelRateCard'
        pricingRules:
          type:
            - object
            - 'null'
          description: >-
            Input/output-conditional overrides of the rate the rateCard names:
            `dimensions` resolved from the request select a `rate` from `rules`,
            with a `default` fallback. When present, the rateCard carries the
            base rate.
          additionalProperties: true
        averageCost:
          type:
            - string
            - 'null'
          description: >-
            Observed average cost of one run (decimal string), where the catalog
            tracks it.
        currency:
          const: USD
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
          description: Human-readable error message.
        request_id:
          type: string
          description: Correlation id for support.
    ModelRateCard:
      description: >-
        Mode-specific rate card, discriminated on `pricingMode`. Deliberately
        structured rather than flattened to a single unit price: each mode's own
        fields carry its rates, so no mode can be misread through another's
        lens. All rates are decimal strings in USD.
      oneOf:
        - type: object
          required:
            - pricingMode
            - pricePerOutput
          properties:
            pricingMode:
              const: per_output
            pricePerOutput:
              type: string
              description: Price per generated output.
        - type: object
          required:
            - pricingMode
            - pricePerOutputSecond
          properties:
            pricingMode:
              const: per_output_second
            pricePerOutputSecond:
              type: string
              description: Price per second of generated media.
        - type: object
          required:
            - pricingMode
            - pricePerMegapixel
          properties:
            pricingMode:
              const: per_megapixel
            pricePerMegapixel:
              type: string
              description: Price per output megapixel.
        - type: object
          required:
            - pricingMode
            - pricePerSecond
          properties:
            pricingMode:
              const: per_second
            pricePerSecond:
              type: string
              description: Price per second of compute.
        - type: object
          required:
            - pricingMode
            - resolutionPricing
          properties:
            pricingMode:
              const: resolution_tiered
            resolutionPricing:
              type: object
              properties:
                tiers:
                  type: array
                  items:
                    type: object
                    properties:
                      preset:
                        type: string
                      pricePerOutputSecond:
                        type: string
                defaultPricePerOutputSecond:
                  type: string
        - type: object
          required:
            - pricingMode
            - megapixelPricing
          properties:
            pricingMode:
              const: megapixel_tiered
            megapixelPricing:
              type: object
              additionalProperties: true
              description: >-
                Tiered (`maxMegapixels` thresholds) or exact (`megapixels` keys)
                price table with an optional `defaultPrice`.
        - type: object
          required:
            - pricingMode
            - tokenPricing
          properties:
            pricingMode:
              const: per_token
            tokenPricing:
              type: object
              additionalProperties: true
              description: >-
                Per-1M-token rates by bucket (`text.input`, `text.output`,
                `cachedInput`, …), optional rounding increment, and an optional
                `displayExample` for non-text outputs.

````