---
title: "List the video models you can use"
method: GET
path: "/api/v1/video-models"
tags: ["Videos"]
---

# List the video models you can use

`GET /api/v1/video-models`

## Request

- Base URL: `https://your-deployment.example.com`
- URL: `https://your-deployment.example.com/api/v1/video-models`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Returns the video models that are enabled, available in this deployment and have a usable provider key for the caller, with their capabilities and per-second credit price. Validate requests against these capabilities: an unsupported duration, aspect ratio or resolution is a 422, never silently adjusted.

## Response `200`

The usable models.

- ListVideoModelsResponse200
  - `models` object[], required
    - `id` string, required
    - `object` 'video_model', required
    - `display_name` string, required
    - `provider` string, required
    - `modes` string[], required
    - `duration` union, required
      - object
        - `kind` 'range', required
        - `min` number, required
        - `max` number, required
        - `step` number, required
      - object
        - `kind` 'discrete', required
        - `values` number[], required
    - `aspect_ratios` string[], required
    - `resolutions` string[], required
    - `defaults` object, required
      - `duration_seconds` number, required
      - `aspect_ratio` '16:9' | '9:16' | '1:1' | '4:3' | '3:4' | '3:2' | '2:3' | '21:9', required
      - `resolution` '360p' | '480p' | '720p' | '1080p' | '4k', required
    - `audio` 'always' | 'optional' | 'none', required
    - `credits_per_second` object, nullable, required: Credits per second of output by resolution; null for per-clip priced models.
    - `deprecation_date` string, nullable, required

## Other responses

- `401`: Missing or invalid credentials.
- `403`: The API key lacks the `ai:generate` scope.
- `405`: The path does not serve this HTTP method.
- `429`: Per-user rate limit exceeded.

---

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