clips

Render the clip (MP4) with its current edit

The edit row is created with the account subtitle preset if the clip was never edited; the export carries eta_s. Enqueues a render job and returns the export with status: queued. Poll getExport every ~5 s until done (then url) or failed (error). A 60 s clip renders in ~30-90 s. 403 on the free plan for the demo video.

post/api/clips/{id}/export

Request

Base URL: https://cliponit.app
URL: https://cliponit.app/api/clips/{id}/export
Auth: one of:
- HTTP bearer
- API key in cookie session
- OAuth 2 (authorization code, authorization URL https://cliponit.app/oauth/authorize, token URL https://cliponit.app/oauth/token, scopes: clips)

Path parameters

idstring uuid required

Example:6f1c2d6e-3b1a-4c0f-9a0e-2f5d1c7b8e90

Clip id (UUID)

Query parameters

orientation'vertical' | 'horizontal' | 'square' | 'portrait45'

vertical = 9:16 1080x1920 (TikTok/Reels/Shorts), horizontal = 16:9 1920x1080 (YouTube), square = 1:1 1080x1080 (feed), portrait45 = 4:5 1080x1350 (Instagram feed). auto-reframe supports vertical|horizontal only.

Which edit/export: vertical (9:16, default), horizontal (16:9), square (1:1) or portrait45 (4:5). Each clip has one independent edit per orientation.

Response

Export (queued)

idstring uuid required

clip_idstring uuid required

user_idstring uuid

orientation'vertical' | 'horizontal' | 'square' | 'portrait45' required

status'queued' | 'running' | 'done' | 'failed' | 'canceled' required

progressinteger required

Render progress in %

eta_snumber nullable

Estimated seconds left while queued/running: moving-average render ratio of the last 10 finished exports × (remaining clip seconds + clips ahead in the queue); null otherwise

started_atstring nullable

finished_atstring nullable

urlstring nullable

/files/exports/<id>.mp4 once done (relative to the server base URL)

output_pathstring nullable

errorstring nullable

created_atstring required

Example response

{
  "id": "6f1c2d6e-3b1a-4c0f-9a0e-2f5d1c7b8e90",
  "clip_id": "6f1c2d6e-3b1a-4c0f-9a0e-2f5d1c7b8e90",
  "user_id": "6f1c2d6e-3b1a-4c0f-9a0e-2f5d1c7b8e90"
}

Changes

No recorded changes to this operation across all 1 revision of this API.