---
title: "List the models you can run. Filters: type=image|video|audio, q=<text>, task=<what you want to make> (adds a recommendation)."
method: GET
path: "/v1/models"
---

# List the models you can run. Filters: type=image|video|audio, q=<text>, task=<what you want to make> (adds a recommendation).

`GET /v1/models`

## Request

- Base URL: `https://api.lumeta.ai`
- URL: `https://api.lumeta.ai/v1/models`
- Auth: HTTP bearer

## Query parameters

- `type` string
- `q` string
- `task` string

## Response `200`

OK

- object
  - `data` Model[]
    - `id` integer
    - `slug` string
    - `name` string
    - `type` 'image' | 'video' | 'audio' | 'other'
    - `description` string
    - `long_description` string, nullable
    - `min_plan` integer: The access level a model needs: 1 Free, 2 and up paid; `min_plan_name` names the plan. Some choices inside a model can need more: `x-lumeta-option-min-plan` in its input schema.
    - `min_plan_name` string: The cheapest plan on sale that opens the model.
    - `base_credits` number: Base price; POST /v1/estimate gives the exact figure for an input.
    - `edits_media` boolean: Takes an image/video/audio in and edits it.
    - `categories` string[]
    - `schema_url` string
    - `schema_hash` string: Changes when the input schema changes.
    - `prompt_guide` object: How to write a prompt for this model, on models that have a guide (Seedance today), GET /v1/models/{model} only: `text` is Markdown, `version` changes when the rules do. It is the guide the website's AI Enhance Prompt follows; Seedance's rules differ between its `engine` 2.0 and 2.5, marked in the text.
      - `version` string
      - `text` string
    - `input_schema` object: JSON Schema 2020-12 of `input` (GET /v1/models/{model} only).
    - `compat` object: Other APIs' names for this model, on models that have one: {"higgsfield": [paths]} are the Higgsfield API paths that run it at https://api.lumeta.ai/higgsfield.
      - `higgsfield` string[]
  - `recommended` object
  - `defaults` object: image, video, audio: the model this account opens with on the web for that kind ({id, slug, name, base_credits}, or null). Run it when only a kind is named.

## Other responses

- `default`: Error

---

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