Skip to content
Hayonix

API reference · Schema

PriceSheet

  • objectstringrequired

    Always `price_sheet`: the type of this object

    One ofprice_sheet

  • versionintegerrequired

    Version of the price list in force; it rises with each new one

  • effective_fromstring (date-time)required

    When these prices took effect (ISO 8601, UTC)

  • currencystringrequired

    Always `usd`

    One ofusd

  • pricesarray of objectrequired

    Every public price, by product, meter and price key

    Show 11 fields of prices
    • productstringrequired

      Product the price belongs to, for example `compute`, `inference`, `batch_inference`, `training` or `storage`

    • meterstringrequired

      What is measured and charged, for example `gpu_second` or `output_token`

    • price_keystringrequired

      What is priced: a hardware type code, a model’s price key, or `batch:` followed by one for batch prices

    • display_namestring | nullrequired

      Name to show people

    • display_unitstring | nullrequired

      The unit to show next to the price, for example `per 1M tokens`; null when none

    • unit_pricestringrequired

      nano-USD per unit_quantity units

      pattern ^-?[0-9]+$

    • unit_quantitystringrequired

      How many units of the meter `unit_price` is for (decimal string)

    • per_secondstring | nullrequired

      Compute: whole nano-USD per second (what is billed)

      pattern ^-?[0-9]+$

    • per_hourstring | nullrequired

      Compute: per_second × 3600 (derived)

      pattern ^-?[0-9]+$

    • placeholderbooleanrequired

      This price is a development placeholder, not an offered price (the model is marked so in the catalog, or the price book in force is a placeholder book)

    • modelobject | nullrequired

      The public catalog model this price belongs to, if any

      Show 5 fields of model
      • slugstringrequired

        Model ID to send in inference requests (`publisher/name`)

      • display_namestringrequired

        Name to show people

      • kindstringrequired

        What the model does: `chat`, `completion`, `embedding`, `rerank`, `image`, `speech_to_text` or `text_to_speech`

      • publisherstring | nullrequired

        Who published the model; null when not recorded

      • context_lengthinteger | nullrequired

        Largest context in tokens; null when it does not apply

  • notesstring | nullrequired

    Operator notes on the price book version in force

  • placeholderbooleanrequired

    The price book in force is a placeholder book (its notes start with "PLACEHOLDER"): show it as a draft, not as offered prices

Example
{
  "object": "price_sheet",
  "version": 1,
  "effective_from": "2026-01-01T00:00:00.000Z",
  "currency": "usd",
  "prices": [
    {
      "product": "string",
      "meter": "string",
      "price_key": "string",
      "display_name": "string",
      "display_unit": "string",
      "unit_price": "1500000000",
      "unit_quantity": "string",
      "per_second": "1500000000",
      "per_hour": "1500000000",
      "placeholder": true,
      "model": {
        "slug": "string",
        "display_name": "string",
        "kind": "string",
        "publisher": "string",
        "context_length": 1
      }
    }
  ],
  "notes": "string",
  "placeholder": true
}

Used by