---
title: "List clip generation models"
method: GET
path: "/clip-models"
tags: ["Clips"]
---

# List clip generation models

`GET /clip-models`

Returns the AI video models available for standalone clip generation, with their capabilities (text-to-video, image-to-video, reference images), supported aspect ratios, resolutions, duration limits, and credit cost per second by resolution. Pick a `modelKey` for `POST /clips`.

## Response `200`

OK

- object[]
  - `modelKey` string, required — Pass this as `modelKey` in POST /clips.
  - `displayName` string, required — Human-readable model name.
  - `family` string, required — Model family grouping.
  - `provider` string, required — The AI provider behind this model.
  - `modelId` string, required — Provider-side model identifier.
  - `supportsTextToVideo` boolean, required — Can generate a clip from a text prompt alone.
  - `supportsImageToVideo` boolean, required — Can animate from a provided image.
  - `supportedAspectRatios` string[], required — Valid `aspectRatio` values for this model.
  - `supportedResolutions` string[], required — Valid `resolution` values for this model.
  - `minDurationSeconds` number, required — Minimum clip length in seconds.
  - `maxDurationSeconds` number, required — Maximum clip length in seconds.
  - `supportedDurationSeconds` number[], required — When non-empty, the model only supports these exact durations.
  - `supportsFirstFrame` boolean, required — Accepts `firstFrameUrl`.
  - `supportsLastFrame` boolean, required — Accepts `lastFrameUrl`.
  - `supportsReferenceImages` boolean, required — Accepts `referenceImageUrls`.
  - `maxReferenceImages` number, required — Maximum number of reference images.
  - `supportsReferenceVideos` boolean, required
  - `maxReferenceVideos` number, required
  - `minReferenceVideoDurationSeconds` number, required
  - `maxReferenceVideoDurationSeconds` number, required
  - `supportsReferenceAudio` boolean, required
  - `maxReferenceAudio` number, required
  - `maxReferenceAudioDurationSeconds` number, required
  - `referenceAudioRequiresVisual` boolean, required
  - `maxReferenceFiles` number, required
  - `supportsAutoDuration` boolean, required
  - `supportsAutoAspectRatio` boolean, required
  - `creditsPerSecondByResolution` object, required — Credit cost per second of clip, keyed by resolution.

## Other responses

- `401` — 401
- `402` — 402
- `403` — 403

---

[API](https://skmtc.net/aituber/apis/aituber-api.md) · [All operations](https://skmtc.net/aituber/apis/aituber-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aituber/aituber-api/revisions/35448566f143/schema)