latestOpenAPI 3.1.12026-08-22330162.7 KB

35448566f143

Clips

List your clips

Returns your standalone AI clips, newest first. For the next page, pass the createdAt of the last clip as cursor. An empty array means there are no more clips.

get/clips

Query parameters

limitinteger

Maximum clips per page (1-50). Default: 20.

cursorstring date-time

Pagination cursor: the createdAt of the last clip from the previous page. Omit for the first page.

Response

idstring uuid required

Clip ID.

titlestring required

Clip title.

statusstring required

Generation status: pending, processing, completed, or failed.

modelKeystring required

The model used.

aspectRatiostring required

Clip aspect ratio.

createdAtstring date-time required

When the clip was created. Use the last item's value as the next cursor.

outputUrlstring nullable required

Download URL for the finished MP4 clip. null until completed.

mediaAssetIdstring nullable required

Internal media asset ID.

errorMessagestring nullable required

Why generation failed, when status is failed.