---
title: "List Models"
method: GET
path: "/v1/models"
tags: ["Public API"]
---

# List Models

`GET /v1/models`

## Request

- Base URL: `https://api.animgen.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.animgen.com/v1/models`
- Auth: HTTP bearer

## Response `200`

Successful Response

- ModelsResponse
  - `object` 'list'
  - `data` ModelCapabilities[], required: Currently enabled models; do not hard-code this list in a client.
    - `id` string, required: Stable provider:model selector for requests; use the live catalog.
    - `provider` string, required: Public provider identifier.
    - `model` string, required: Model identifier within the provider.
    - `label` string, required: Human-readable model label.
    - `modes` string[], required: Supported input modes, such as first_frame, first_last_frame, or reference_images.
    - `durations` integer[], required: Supported generation durations in seconds; also inspect resolution-specific constraints.
    - `resolutions` string[], required: Supported resolution values.
    - `ratios` string[], required: Supported aspect ratio values; check ratios_by_mode where present.
    - `default_duration_seconds` integer, required: Default generation duration in seconds.
    - `default_resolution` string, nullable, required: Default resolution, or null when not applicable.
    - `default_ratio` string, nullable, required: Default ratio, or null when not applicable.
    - `supports_seed` boolean, required: Whether seed is supported.
    - `supports_watermark` boolean, required: Whether the watermark setting is supported.
    - `supports_first_frame` boolean, required: Whether a first-frame input is supported.
    - `supports_last_frame` boolean, required: Whether a last-frame input is supported.
    - `supports_negative_prompt` boolean, required: Whether negative_prompt is supported.
    - `supports_reference_images` boolean, required: Whether reference-image mode is supported.
    - `max_reference_images` integer, required: Model reference-image capacity; the first frame occupies the first reference slot in reference mode.
    - `reference_image_duration_seconds` integer, nullable, required: Required duration for reference mode, when constrained.
    - `requires_prompt` boolean, required: Whether prompt must be nonempty.
    - `returns_last_frame` boolean, required: Whether the model can return a last-frame asset.
    - `aspect_ratio_mode` string, required: Provider's aspect-ratio handling mode.
    - `ratios_by_mode` object: Input-mode-specific supported ratios.
    - `durations_by_resolution` object: Resolution-specific supported durations in seconds.

---

[API](https://skmtc.dev/animgen/apis/aianimgenbackend.md) · [All operations](https://skmtc.dev/animgen/apis/aianimgenbackend/llms.txt) · [OpenAPI document](https://skmtc.dev/animgen/apis/aianimgenbackend/revisions/ac3744fbb14e?raw)