---
title: "List video models"
method: GET
path: "/video/models"
tags: ["Videos"]
---

# List video models

`GET /video/models`

## Request

- Base URL: `https://api.wondercraft.ai/v1`
- URL: `https://api.wondercraft.ai/v1/video/models`
- Auth: API key in header `X-API-KEY`
- TypeScript: <https://skmtc.dev/wondercraft/apis/wondercraft-public-api/docs/video/models/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists the video models available through the API, with the modes, resolutions (and credits per
second at each), durations and aspect ratios each one supports. Requires a valid `X-API-KEY` header.

## Response `200`

Successful Response

- ListVideoModelsResponse
  - `models` ApiVideoModel[], required: Video models available through the API
    - `id` string, required: Model ID to pass as `model_id` when generating
    - `title` string, required: Display name of the model
    - `description` string, required: What the model is good at
    - `modes` ApiVideoMode[], required: Generation modes this model supports
    - `resolutions` ApiVideoResolutionOption[], required: Supported resolutions and their price
      - `resolution` '480p' | '720p' | '1080p' | '2k' | '4k', required: Output resolution shared by the image and video APIs; each model lists the values it supports.
      - `label` string, required: Size the model renders at this tier, e.g. 360p for a 480p tier
      - `credits_per_second` number, required: Credits charged per generated second at this tier
    - `default_resolution` '480p' | '720p' | '1080p' | '2k' | '4k', required: Output resolution shared by the image and video APIs; each model lists the values it supports.
    - `durations` integer[], required: Supported output durations in seconds
    - `default_duration` integer, required: Duration used when the request sends none
    - `aspect_ratios` ApiAspectRatio[], required: Aspect ratios this model supports
    - `supports_audio` boolean, required: Whether the output includes generated audio
    - `max_reference_images` integer, nullable: Maximum `reference_image_ids` in references mode, or null when not supported
    - `max_reference_videos` integer, nullable: Maximum `reference_video_ids` in references mode, or null when not supported
    - `output_duration_follows_source` boolean, required: In video_to_video mode the output is as long as the source clip, and `duration` is not sent

## Changes

- **2026-10-16** `200f24d7f14b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/wondercraft/apis/wondercraft-public-api/changes/video/models/get.md)

---

[API](https://skmtc.dev/wondercraft/apis/wondercraft-public-api.md) - [All operations](https://skmtc.dev/wondercraft/apis/wondercraft-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wondercraft/apis/wondercraft-public-api/revisions/200f24d7f14b?raw)