Sign in
latestOpenAPI 3.1.12026-08-22330162.7 KB

35448566f143

Clips

Generate a standalone AI video clip

Starts generating a single AI video clip (1-30 seconds) from a text prompt, an image, or both. This is different from POST /videos/generate: no narration, no captions, just one raw clip.

Flow: pick a model from GET /clip-models, create the clip, then poll GET /clips/{id} until status is completed and download from outputUrl. Typical generation takes 1-3 minutes.

Cost: per second of clip, by model and resolution (see creditsPerSecondByResolution in GET /clip-models). Credits are reserved when the clip starts and refunded automatically if generation fails.

Requires an active paid subscription.

post/clips

Request body

titlestring

Optional clip title. Defaults to the start of the prompt.

modelKeystring required

The generation model to use. Get valid keys, capabilities, and per-second costs from GET /clip-models.

promptstring

What the clip should show. Required for text-to-video models; optional when animating from images.

aspectRatio'auto' | '16:9' | '9:16' | '4:3' | '3:4' | '1:1' | '21:9' | '3:2' | '2:3' | '9:21' | '5:4' | '4:5'

Clip dimensions. Check the model's supportedAspectRatios from GET /clip-models. Default: "16:9".

resolutionstring

Output resolution (e.g. "720p", "1080p"). Check the model's supportedResolutions. Higher resolutions cost more credits per second. Default: "720p".

firstFrameUrlstring

Public image URL to use as the first frame (image-to-video). Only for models with supportsFirstFrame.

lastFrameUrlstring

Public image URL to use as the last frame. Only for models with supportsLastFrame.

referenceImageUrlsstring[]

Public image URLs used as style/subject references. Only for models with supportsReferenceImages; respect maxReferenceImages.

referenceVideoUrlsstring[]

Public video URLs used for motion, editing, or extension. Check model capabilities first.

referenceAudioUrlsstring[]

Public audio URLs used for voice, lip sync, rhythm, or timing. Check model capabilities first.

Response

OK

idstring uuid required

Clip ID. Poll GET /clips/{id} until completed.

status'pending' required

Initial status.

estimatedCreditsnumber required

Credits reserved for this generation.