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

# List generation models

`GET /api/v1/models`

## Request

- Base URL: `https://viewmax.studio`
- URL: `https://viewmax.studio/api/v1/models`
- Auth: none required

Public catalog of video, image, or music models with modes, accepted option values, defaults, and credit pricing. No API key required. Cached for up to an hour.

## Query parameters

- `type` 'video' | 'image' | 'music'

## Response `200`

Model catalog. The item shape depends on `type`: VideoModel, ImageModel, or MusicModel.

- object
  - `code` 0, required
  - `message` 'ok', required
  - `data` object, required
    - `models` union[], required
      - union
        - VideoModel
          - `id` string, required: Send as `model`.
          - `label` string, required
          - `vendor` string, required
          - `description` string, required
          - `modes` object, required: Keyed by mode id; only supported modes are present.
          - `credits_label` string, required
          - `coming_soon` boolean, required
          - `max_prompt_length` integer: Longest accepted prompt in characters, after trimming. Absent when the model sets none.
        - ImageModel
          - `id` string, required: Send as `model`.
          - `label` string, required
          - `vendor` string, required
          - `description` string, required
          - `modes` object, required: Keyed by scene: `text-to-image`, `image-to-image`.
          - `credits_label` string, required
        - MusicModel
          - `id` string, required
          - `label` string, required
          - `vendor` string, required
          - `description` string, required
          - `controls` object, required: Accepted `options` for POST /api/v1/music.
          - `credits` integer, required: Price for tracks up to 60 s. Longer tracks cost 1 credit per second: `max(60, ceil(duration_seconds))`.

---

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