---
title: "List generative models"
method: GET
path: "/api/v1/generation/models"
tags: ["model"]
---

# List generative models

`GET /api/v1/generation/models`

## Query parameters

- `category` 'image' | 'video' | 'text' | 'image_tool' | 'video_tool' | 'audio', required

## Response `200`

200

- object
  - `models` object[], required
    - `name` string, required
    - `displayName` string, required
    - `releasedAt` string, nullable
    - `variants` object[], required
      - `mode` string, required
      - `tier` string, nullable, required
      - `requiredInputs` string[], required
      - `optionalInputs` string[], required
      - `supportsSeed` boolean, required
      - `supportsAudioGeneration` boolean
      - `supportsAudioToggle` boolean
      - `supportsNegativePrompt` boolean
      - `supportedAspectRatios` string[], required
      - `supportedDurations` number[], nullable, required
      - `billedDurationSource` union
        - 'input-media'
        - number
      - `supportedDurationsByResolution` object, nullable
      - `supportedResolutions` union[], nullable, required
        - union
          - '360p' | '480p' | '540p' | '580p' | '720p' | '1080p' | '1440p' | '2160p' | '4k' | '0.5K' | '1K' | '2K' | '4K' | '1k' | '2k'
          - string
      - `supportsCustomResolution` boolean
      - `maxImageInputs` number, nullable, required
      - `maxReferenceImageInputs` number, nullable
      - `maxReferenceImagesWithEndImage` number, nullable
      - `maxVideoInputs` number, nullable
      - `maxAudioInputs` number, nullable
      - `maxNativeOutputs` number, nullable, required
      - `maxInputArea` number, nullable, required
      - `inputImageFileSizeConstraints` object, nullable
        - `maximumFileBytes` integer
        - `maximumTotalBytes` integer
      - `inputReferenceImageFileSizeConstraints` object, nullable
        - `maximumFileBytes` integer
        - `maximumTotalBytes` integer
      - `inputImageDimensionConstraints` object, nullable
        - `minimumWidth` integer, required
        - `minimumHeight` integer, required
        - `maximumWidth` integer
        - `maximumHeight` integer
      - `inputImageAspectRatioConstraints` object, nullable
        - `maximumRatio` number, required
      - `inputImageMimeTypes` string[], nullable
      - `inputReferenceImageMimeTypes` string[], nullable
      - `minInputVideoArea` number, nullable
      - `maxInputVideoDurationSeconds` number, nullable
      - `minInputVideoDurationSeconds` number, nullable
      - `maxPromptLength` number, nullable
      - `minPromptLength` number, nullable
      - `estimatedLatency` string, nullable, required
      - `estimatedLatencySeconds` number, nullable
      - `defaultResolution` union
        - '360p' | '480p' | '540p' | '580p' | '720p' | '1080p' | '1440p' | '2160p' | '4k' | '0.5K' | '1K' | '2K' | '4K' | '1k' | '2k'
        - string
      - `featuredDescription` string, nullable, required
      - `cost` union
        - object
          - `type` 'fixed', required
          - `creditCost` number, required
        - object
          - `type` 'fixed_duration', required
          - `creditCost` number, required
          - `durationSeconds` number, required
        - object
          - `type` 'per_second', required
          - `creditCostPerSecond` number, required
        - object
          - `type` 'per_minute', required
          - `creditCostPerMinute` number, required
        - object
          - `type` 'per_megapixel_frame', required
          - `creditCostPerMegapixelFrame` number, required
          - `estimatedCreditCost` number
        - object
          - `type` 'estimated', required
          - `creditCost` number, required
    - `supportedInputs` string[]
    - `estimatedLatency` string, nullable
    - `estimatedLatencySeconds` number, nullable
    - `featuredDescription` string, nullable
    - `cost` union, required
      - object
        - `type` 'fixed', required
        - `creditCost` number, required
      - object
        - `type` 'fixed_duration', required
        - `creditCost` number, required
        - `durationSeconds` number, required
      - object
        - `type` 'per_second', required
        - `creditCostPerSecond` number, required
      - object
        - `type` 'per_minute', required
        - `creditCostPerMinute` number, required
      - object
        - `type` 'per_megapixel_frame', required
        - `creditCostPerMegapixelFrame` number, required
        - `estimatedCreditCost` number
      - object
        - `type` 'estimated', required
        - `creditCost` number, required
    - `deprecated` boolean
    - `hiddenFromAgent` boolean
    - `promoRateLimit` object
      - `used` integer, required
      - `limit` integer, required
      - `remaining` integer, required
    - `maxPromptLength` number, nullable

## Other responses

- `401` — Missing, invalid, expired, or revoked API key.
- `403` — The API key's user is not a member of the requested team.
- `429` — Rate limit reached — retry after the `Retry-After` header.

---

[API](https://skmtc.net/melius/apis/melius-api.md) · [All operations](https://skmtc.net/melius/apis/melius-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/melius/melius-api/revisions/c48e2a9e4b72/schema)