Thumbnails, clips & export

Extract poster frames, cut a sub-segment into a new asset, and re-wrap into a different container.

Poster frame thumbnails

Extract one or more poster frames at arbitrary timecodes:

curl -X POST https://<your-instance>/api/v1/assets/<id>/thumbnails \
  -H "Content-Type: application/json" \
  -d '{"timecodes": ["00:00:05", "00:01:30"]}'

List them with GET /api/v1/assets/{id}/thumbnails, or fetch one by index with GET /api/v1/assets/{id}/thumbnails/{index}.

Clip a segment

Cut a time range out of an asset into a new, independent child asset — the source is untouched:

curl -X POST https://<your-instance>/api/v1/assets/<id>/clip \
  -H "Content-Type: application/json" \
  -d '{"startTime": "00:02:00", "endTime": "00:02:30"}'

Export / re-wrap

Change container format (e.g. MP4 → MOV) without re-encoding the essence:

curl -X POST https://<your-instance>/api/v1/assets/<id>/export \
  -H "Content-Type: application/json" \
  -d '{"format": "mov"}'

Both clip and export return a job — poll it the same way as a transcode job. Full request/response shapes in the Assets reference.