Get public pricing catalog

GET/api/v1/pricing/catalogCopy URL

Public · no API key

Returns the public pricing catalog used by omnapi.com and docs. The catalog is generated from the same runtime pricing functions used for task credit deduction.

All endpointsRequestResponsesCode

Request

No request parameters.

Responses

200 OK

application/json

Unknown fields are not accepted.

• Response 200 · apiPricingDetailsRequired

  array<object>
  1 field

  • Response 200 · apiPricingDetails[]Each item

    object

    Unknown fields are not accepted.

    16 fields

    • Response 200 · apiPricingDetails[].apiNameRequired

      string

    • Response 200 · apiPricingDetails[].billingUnitRequired

      string

    • Response 200 · apiPricingDetails[].endpointRequired

      string

    • Response 200 · apiPricingDetails[].idRequired

      string

    • Response 200 · apiPricingDetails[].operationRequired

      string

    • Response 200 · apiPricingDetails[].productLineRequired

      string

    • Response 200 · apiPricingDetails[].allowedValuesOptional

      array<string>
      1 field

      • Response 200 · apiPricingDetails[].allowedValues[]Each item

        string

    • Response 200 · apiPricingDetails[].costLabelOptional

      string

    • Response 200 · apiPricingDetails[].creditsOptional

      number

    • Response 200 · apiPricingDetails[].creditsLabelOptional

      string

    • Response 200 · apiPricingDetails[].exampleLabelOptional

      string

    • Response 200 · apiPricingDetails[].modelOptional

      string

    • Response 200 · apiPricingDetails[].notesOptional

      string

    • Response 200 · apiPricingDetails[].parametersOptional

      string

    • Response 200 · apiPricingDetails[].pricingFormulaOptional

      object

      Unknown fields are not accepted.

      6 fields

      • Response 200 · apiPricingDetails[].pricingFormula.creditsPerUnitRequired

        number

      • Response 200 · apiPricingDetails[].pricingFormula.defaultCostGuardUsdPerUnitRequired

        number

      • Response 200 · apiPricingDetails[].pricingFormula.kindRequired

        "duration"

      • Response 200 · apiPricingDetails[].pricingFormula.minimumCreditsRequired

        number

      • Response 200 · apiPricingDetails[].pricingFormula.referenceUsdPerUnitRequired

        number

      • Response 200 · apiPricingDetails[].pricingFormula.unitSecondsRequired

        number

    • Response 200 · apiPricingDetails[].sourceBasisOptional

      string

• Response 200 · apiProductsRequired

  array<object>
  1 field

  • Response 200 · apiProducts[]Each item

    object

    Unknown fields are not accepted.

    11 fields

    • Response 200 · apiProducts[].categoryRequired

      string

    • Response 200 · apiProducts[].descriptionRequired

      string

    • Response 200 · apiProducts[].iconRequired

      string

    • Response 200 · apiProducts[].idRequired

      string

    • Response 200 · apiProducts[].nameRequired

      string

    • Response 200 · apiProducts[].costLabelOptional

      string

    • Response 200 · apiProducts[].creditsLabelOptional

      string

    • Response 200 · apiProducts[].creditsPerRequestOptional

      number

    • Response 200 · apiProducts[].docsPathOptional

      string

    • Response 200 · apiProducts[].includeInUsageExamplesOptional

      boolean

    • Response 200 · apiProducts[].usageUnitLabelOptional

      string

• Response 200 · checkoutFeeBpsRequired

  number

  Minimum: 0. Multiple of: 1.

• Response 200 · creditPackagesRequired

  array<object>
  1 field

  • Response 200 · creditPackages[]Each item

    object

    Unknown fields are not accepted.

    5 fields

    • Response 200 · creditPackages[].creditsRequired

      number

    • Response 200 · creditPackages[].descriptionRequired

      string

    • Response 200 · creditPackages[].idRequired

      string

    • Response 200 · creditPackages[].nameRequired

      string

    • Response 200 · creditPackages[].priceRequired

      number

      Package price in USD.

• Response 200 · creditsExpirationYearsRequired

  number

  Minimum: 0.

• Response 200 · mvOmnV1Required

  object

  Omn V1 MV render-tier price card (generation.engineVersion=omn-v1), generated from the same configuration Task pricing uses. Quotes, preflight and upgrade preflight remain authoritative for a concrete request (add-ons and admission).

  Unknown fields are not accepted.

  12 fields

  • Response 200 · mvOmnV1.composeCreditsPerOperationRequired

    number

    Minimum: 0.

  • Response 200 · mvOmnV1.customerDiscountsRequired

    boolean

    Whether customer-specific discounts apply to new Omn orders; currently false.

  • Response 200 · mvOmnV1.economyScheduleRequired

    object

    Unknown fields are not accepted.

    5 fields

    • Response 200 · mvOmnV1.economySchedule.lastShotStartRequired

      string

      Latest time a shot starts in the window (HH:MM).

    • Response 200 · mvOmnV1.economySchedule.timeZoneRequired

      string

      IANA time zone of the window.

    • Response 200 · mvOmnV1.economySchedule.videoMultiplierRequired

      number

      Multiplier on the generation's video component for generation.schedule=economy.

      Minimum: 0.

    • Response 200 · mvOmnV1.economySchedule.windowEndRequired

      string

      Off-peak window end (HH:MM).

    • Response 200 · mvOmnV1.economySchedule.windowStartRequired

      string

      Off-peak window start (HH:MM).

  • Response 200 · mvOmnV1.engineVersionRequired

    "omn-v1"

  • Response 200 · mvOmnV1.generationRequired

    object

    Unknown fields are not accepted.

    1 field

    • Response 200 · mvOmnV1.generation.minimumBilledSecondsRequired

      number

      Minimum: 0.

  • Response 200 · mvOmnV1.notesRequired

    string

  • Response 200 · mvOmnV1.pricingPolicyRequired

    string

  • Response 200 · mvOmnV1.pricingVersionRequired

    string

    Omn V1 public price card version; Task pricing snapshots record the version they were priced with.

  • Response 200 · mvOmnV1.renderTiersRequired

    array<object>
    1 field

    • Response 200 · mvOmnV1.renderTiers[]Each item

      object

      Unknown fields are not accepted.

      3 fields

      • Response 200 · mvOmnV1.renderTiers[].minimumOrderCreditsRequired

        number

        Minimum video credits for a full generation or upgrade; not applied to shot edits.

        Minimum: 0.

      • Response 200 · mvOmnV1.renderTiers[].pricesRequired

        array<object>

        Delivery resolutions the tier offers and their credits per output second; a resolution that is not listed is not offered at that tier.

        1 field

        • Response 200 · mvOmnV1.renderTiers[].prices[]Each item

          object

          Unknown fields are not accepted.

          1 field

          • Response 200 · mvOmnV1.renderTiers[].prices[]See schema

            object

            Expand this value in the interactive reference.

            Unknown fields are not accepted.

      • Response 200 · mvOmnV1.renderTiers[].renderTierRequired

        "draft" | "standard" | "hd" | "ultra"

  • Response 200 · mvOmnV1.sceneEditRequired

    object

    Unknown fields are not accepted.

    3 fields

    • Response 200 · mvOmnV1.sceneEdit.economyDiscountRequired

      boolean

      Whether the economy schedule multiplier applies.

    • Response 200 · mvOmnV1.sceneEdit.minimumBilledSecondsRequired

      number

      Minimum: 0.

    • Response 200 · mvOmnV1.sceneEdit.ruleRequired

      string

  • Response 200 · mvOmnV1.unitRequired

    "credits_per_output_second"

  • Response 200 · mvOmnV1.upgradeRequired

    object

    Unknown fields are not accepted.

    3 fields

    • Response 200 · mvOmnV1.upgrade.economyDiscountRequired

      boolean

      Whether the economy schedule multiplier applies.

    • Response 200 · mvOmnV1.upgrade.minimumBilledSecondsRequired

      number

      Minimum: 0.

    • Response 200 · mvOmnV1.upgrade.ruleRequired

      string

• Response 200 · updatedAtRequired

  string

  Catalog effective date in YYYY-MM-DD format.

  Format: date.

• Response 200 · versionRequired

  string

  Immutable pricing-catalog version.

• Response 200 · welcomeCreditsRequired

  number

  Minimum: 0.

429 Too Many Requests

Request allowance or task admission capacity exceeded. Follow Retry-After when present; otherwise wait for active tasks and use bounded backoff. Limits do not guarantee throughput. For SSE, this is the HTTP connection response, not an event.

application/json

• Response 429 · errorRequired

  object
  3 fields

  • Response 429 · error.codeRequired

    string

    RATE_LIMITED for request and task admission rejections.

  • Response 429 · error.messageRequired

    string

  • Response 429 · error.detailsOptional

    object

    Optional and scope-dependent. Request limits supply scope/policy/type/limit/current/retryAfterSec. Task admission supplies inFlight/limit/tier, plus scope=apiKey for a key cap. IP rejection can omit details. In-flight rejection does not promise Retry-After.

    8 fields

    • Response 429 · error.details.currentOptional

      integer

      Minimum: 0.

    • Response 429 · error.details.inFlightOptional

      integer

      Minimum: 0.

    • Response 429 · error.details.limitOptional

      integer

      Minimum: 0.

    • Response 429 · error.details.policyOptional

      "operation" | "query"

    • Response 429 · error.details.retryAfterSecOptional

      integer

      Minimum: 1.

    • Response 429 · error.details.scopeOptional

      "user" | "api-key" | "ip" | "apiKey"

    • Response 429 · error.details.tierOptional

      "FREE" | "PREMIUM" | "ENTERPRISE"

    • Response 429 · error.details.typeOptional

      "rps" | "daily" | "monthly"

• Response 429 · successRequired

  false

  Default: false.

500 Internal Server Error

application/json

• Response 500 · errorRequired

  object
  3 fields

  • Response 500 · error.codeRequired

    string

    Application-specific error code (see error catalog)

  • Response 500 · error.messageRequired

    string

    Human readable error message

  • Response 500 · error.detailsOptional

    object

    Additional error details (optional)

• Response 500 · successRequired

  false

  Always false for error responses

Request example

Wrap lines

cURL

curl --globoff --request GET \
  --url 'https://api.omnapi.com/api/v1/pricing/catalog'

Node.js

const response = await fetch("https://api.omnapi.com/api/v1/pricing/catalog", {
  method: "GET",
  headers: {

  },
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.text());

Python

import os
import requests

response = requests.request(
    "GET", "https://api.omnapi.com/api/v1/pricing/catalog",
    headers={

    },
    timeout=60,
)
response.raise_for_status()
print(response.text)

Set URL and header variables.

Interactive API Explorer → · OpenAPI JSON