v2

latestOpenAPI 3.1.02026-07-26232135.9 KB

Videos

List Videos

List videos for the authenticated API key with optional pagination.

Filters by the calling user's ID (and org if present)
Ordered by creation time ascending or descending
Supports cursor pagination using the after video ID

get/v1/videos

Query parameters

afterstring nullable

Return items strictly after this video ID

limitinteger

Max number of items to return

order'asc' | 'desc'

Sort order by creation time

Headers

x-api-keystring required

API Key for authentication

Response

Successful Response

idstring required

Video generation job ID

object'video'

status'PROCESSING' | 'COMPLETE' | 'FAILED' | 'CANCELLED' required

Current state of the video

created_atinteger required

When the video was created (unix timestamp)

completed_atinteger nullable

When processing completed (unix timestamp)

progressinteger nullable

Progress percentage (0-100)

model'mirage-video-1-latest' nullable

Model used for generation (only for source='generation')

source_video_idstring nullable

The input video that was captioned (only for source='caption')

caption_template_idstring nullable

Caption style template used (only for source='caption')

share_link_urlstring nullable

Public share link for a completed internal video, when enabled.

video_idstring required

[Deprecated] Use "id" instead.

Example response

[
  {
    "completed_at": 1730822520,
    "created_at": 1730822400,
    "model": "mirage-video-1-latest",
    "progress": 100,
    "status": "COMPLETE",
    "video_id": "video_abc123def456"
  }
]

All 23 operations