latestOpenAPI 3.1.12026-08-22330162.7 KB

35448566f143

Exports

Export a video to MP4

Starts rendering a completed video into a downloadable MP4 file. The rendering runs in the background and typically takes 30 seconds to 5 minutes depending on video length.

Cost: Free. All credits were already consumed during video generation.

Requires: A prior paid subscription.

After exporting:

  1. Poll GET /videos/{id} and check the exportStatus field until it is completed.
  2. Then call GET /exports/download?videoId={id} to get the download URL.
post/exports

Request body

videoIdstring uuid required

The ID of the video to export. The video must have status: completed.

resolution'1080p' | '4k'

Export resolution.

  • 1080p (default): Full HD (1920x1080 or 1080x1920 for vertical). Fast rendering.
  • 4k: Ultra HD (3840x2160 or 2160x3840 for vertical). Slower rendering, larger file.

Response

Export started

exportIdstring uuid required

Unique export identifier. Use this to track export status.

videoIdstring uuid required

The video being exported.

status'pending' | 'processing' | 'completed' | 'failed' required

Export rendering status.

  • pending: Export is queued.
  • processing: Rendering in progress.
  • completed: MP4 ready for download.
  • failed: Rendering failed.
resolutionstring required

The resolution requested for this export.

createdAtstring date-time required

When the export was started (ISO 8601).