---
title: "List enabled models"
method: GET
path: "/v1/catalog/models"
tags: ["Catalog"]
---

# List enabled models

`GET /v1/catalog/models`

## Request

- Base URL: `https://api.lizzflix.xyz` (the document declares no server; this is the origin it was published from)
- URL: `https://api.lizzflix.xyz/v1/catalog/models`
- Auth: none declared

Returns every enabled model with its capabilities (metadata.capabilities), whether scenes can render with it (sceneRenderable), a credit price table for its standard jobs and a billing preview.

## Response `200`

List of enabled models

- object
  - `models` ModelDescriptor[], required
    - `key` string, required
    - `displayName` string, required
    - `executionProvider` 'openrouter' | 'fal' | 'runway' | 'elevenlabs', required
    - `modelVendor` string, required
    - `providerModelId` string, required
    - `lifecycle` 'preview' | 'current' | 'stable' | 'deprecated', required
    - `enabled` boolean, required
    - `modality` 'text' | 'image' | 'video' | 'audio' | 'multimodal', required
    - `pricing` Pricing, required
      - `type` 'per-token' | 'per-character' | 'per-image' | 'per-second' | 'flat' | 'per-image-tiered' | 'per-clip-tiered' | 'per-second-audio-variant' | 'runway-credits' | 'per-second-rounded' | 'per-second-tiered', required
      - `currency` 'USD', required
      - `inputPerMillion` number
      - `outputPerMillion` number
      - `perImage` number
      - `perSecond` number
      - `perCharacter` number
      - `flat` number
      - `defaultTier` string: Tiered shapes: the tier priced when the request names none.
      - `tiers` object
      - `noAudio` number
      - `audio` number
      - `audioVoiceControl` number
      - `unit` 'image' | 'second': runway-credits: what creditsPerUnit counts.
      - `creditsPerUnit` number
      - `resolutionTiers` object
      - `audioVariant` object
        - `noAudio` number, required
        - `audio` number, required
      - `minimumCredits` number
      - `minimumUsd` number
      - `roundingSeconds` number
      - `billedDuration` union
        - 'exact' | 'ceil-int'
        - object
          - `blockSeconds` number, required
      - `allowanceUsd` number
      - `perReferenceImageUsd` number
      - `freeReferenceImages` number
      - `perStartFrameUsd` number
      - `perInputVideoSecondUsd` number
      - `estimatedFromRetailPoints` number
    - `billingPreview` BillingPreview
      - `kind` 'per_second' | 'per_clip' | 'per_image' | 'flat' | 'per_character' | 'per_call', required
      - `minimumCredits` number, required
      - `creditsPerSecond` number
      - `creditsPerClip` number
      - `creditsPerImage` number
      - `creditsPer1kCharacters` number
      - `displayLabel` string, required
      - `pricingSource` string, required
    - `sceneRenderable` boolean, required: Video models only: scenes can render with it now (a scene saving this key renders it, on a live binding with a verified adapter).
    - `priceTable` PriceTable
      - `fromCredits` number, required: The cheapest standard job: pickers show "from N cr" per basis.
      - `basis` object, required
        - `unit` 'seconds' | 'image' | 'characters' | 'call', required
        - `quantity` number, required
      - `rows` object[], required
        - `operation` string
        - `credits` number, required
        - `finalCredits` number
        - `durationSeconds` number
        - `billedSeconds` number
        - `resolution` string
        - `tier` string
        - `audio` boolean
        - `referenceImages` number
        - `characters` number
    - `metadata` object
      - `capabilities` ModelCapabilities: Capabilities v2, next to the older boolean flags (supportsImageToVideo, maxReferenceImages, ...), which stay.
        - `capabilitiesVersion` 2
        - `tier` 'draft' | 'standard' | 'premium'
        - `licence` 'commercial' | 'research-only'
        - `durations` union: Output seconds the model takes. Requests round up to the next allowed value; longer ones are refused.
          - object
            - `min` number, required
            - `max` number, required
          - object
            - `values` number[], required
        - `durationRules` object[]
          - `resolution` string, required
          - `values` number[], required
        - `resolutions` object: Output resolutions; scene previews render at `preview`, finals at `default`.
          - `values` string[], required
          - `default` string, required
          - `preview` string
        - `aspectRatios` string[]
        - `audio` object
          - `native` boolean, required
          - `toggle` boolean, required
          - `defaultOn` boolean, required
          - `speechLanguages` string[]
        - `frames` object
          - `first` 'required' | 'optional' | 'none', required
          - `last` boolean, required
        - `references` object
          - `images` number, required
          - `videos` number
          - `audio` number
          - `maxTotal` number
          - `maxTotalWithVideo` number
          - `maxCharacters` number: Characters the model keeps consistent; clients warn above it.
          - `required` boolean
        - `seed` boolean
        - `negativePrompt` boolean
        - `promptLimit` object
          - `chars` number
          - `utf8Bytes` number
        - `spokenLanguages` string[]
        - `adapterVerified` union: Whether a live test checked the provider request body, for every operation or per operation.
          - boolean
          - object
    - `referenceLimits` ReferenceLimit[]: The reference image limits of this model's operations that take images, from the binding the worker enforces (GET /v1/studio/reference-limits serves the same). Absent for models that take none.
      - `modelKey` string, required
      - `operation` string, required
      - `slot` string, required
      - `minImages` integer, required
      - `maxImages` integer, nullable, required: Null when the binding sets no limit.
      - `maxCharacterImages` integer, nullable, required: Characters whose identity the model keeps reliably; above it, warn (or refuse when characterLimitMode is hard).
      - `characterLimitMode` 'advisory' | 'hard', required
      - `acceptedMimeTypes` string[], required
      - `maxBytes` integer, nullable, required
      - `strictInputs` boolean, required: The provider refuses other types and sizes: without Cloudflare Images to convert them, such a reference is refused (400).
      - `providerBillsPerReference` boolean, required

---

[API](https://skmtc.dev/lizzflix/apis/lizzflix-api.md) · [All operations](https://skmtc.dev/lizzflix/apis/lizzflix-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lizzflix/apis/lizzflix-api/revisions/4536ce9d80ff?raw)
