WIwithchima
Videos

Start a video export

Changed on

Starts an export of the specified video. Export processing is asynchronous: poll GET /v1/videos/{id}/exports/{exportId} for status and a download URL, or listen for the export.ready webhook. Creators and editors can always export. Viewers can only start an export if the video's download settings allow it: video and clips granularity require downloads to be enabled; tracks and raw require both downloads and raw downloads to be enabled.

post/v1/videos/{id}/exports

Request

Path parameters

idstring required

Unique video identifier

Example:vid_abc123def456

Request body

fps'30' | '60'

Frames per second. 60 FPS requires the video creator's Premium plan (including Enterprise Premium), or Pro (including Enterprise) for videos up to 5 minutes after cuts. Not available during a free trial.

granularity'video' | 'clips' | 'tracks' | 'raw'

Export granularity: video (full video), clips (one composed file per clip), tracks (camera and screen files per clip with timeline cuts applied), raw (original recordings without cuts)

resolution'1080p' | '4k'

Export resolution. Default is 1080p. 4K requires the video creator's paid plan and is not available during a free trial.

speed'1' | '2' | '0.5' | '0.75' | '0.8' | '0.9' | '1.1' | '1.2' | '1.25' | '1.3' | '1.35' | '1.5' | '1.7' | '1.75' | '2.5'

Playback speed multiplier. Any speed other than 1 requires the video creator's paid plan and is not available during a free trial.

subtitlesboolean

Burn subtitles into the video

Example request

{
  "fps": "30",
  "granularity": "video",
  "resolution": "1080p",
  "speed": "1"
}

Response

OK

Example response

{
  "export": {
    "downloadUrl": "https://cdn.tella.tv/exports/vid_abc123/video.mp4",
    "exportId": "Export-Story-vid_abc123def456/2026-01-15T10:00:00Z/Story/1920x1080/30FPS",
    "progress": 100,
    "status": "completed",
    "updatedAt": "2024-01-15T15:00:00.000Z"
  }
}

Changes

  • 0cc3fcd307adRevision changes
    • info

      added the new 0.8 enum value to the request property

    • info

      added the new 0.9 enum value to the request property

    • info

      added the new 1.1 enum value to the request property

    • info

      added the new 1.2 enum value to the request property

    • info

      added the new 1.3 enum value to the request property

    • info

      added the new 1.35 enum value to the request property

    • info

      added the new 1.7 enum value to the request property

    • info

      added the new 2.5 enum value to the request property

  • ac47c99c144fRevision changes
    • warning

      added the new edit_conflict enum value to the response property for the response status

    • warning

      added the new edit_conflict enum value to the response property for the response status

    • warning

      added the new edit_conflict enum value to the response property for the response status

    • warning

      added the new edit_conflict enum value to the response property for the response status

    • warning

      added the new edit_conflict enum value to the response property for the response status

    • warning

      added the new edit_conflict enum value to the response property for the response status

    • warning

      added the new edit_conflict enum value to the response property for the response status

    • warning

      added the new edit_conflict enum value to the response property for the response status

    • warning

      added the new edit_conflict enum value to the response property for the response status