Export a video clip
POST
https://api.tvunetworks.com/export
the result to a caller-specified cloud storage location.
and returns
errorCode: 1000 with a non-zero timeWait. The client must re-submit theidentical request body at
timeWait-millisecond intervals until errorCode reachesa terminal state:
1005 (Work Finish) — export succeeded; read videoPath, fileSize, videoDuration.1001 code — export failed; read errorMsg.fileName (or an auto-generated hash ofhighResolutionMediaFilePath + startTime + duration when omitted). Submitting thesame body while a job is in progress returns the current task state without spawning
a duplicate job.
isDryrun (default true) — validate the request without performing the actual export.Set to
false to trigger a real export.isFrameLevel — enable sub-GOP frame-accurate cut points.isCover — overwrite the output file if it already exists (default false; returns1100 if the file exists and this flag is not set).withMetadataJson — also produce a companion JSON metadata sidecar alongside the video.audioPadding / videoPadding — prepend/append silent audio or black-frame padding.Error Codes
| Code | Message | Cause |
|---|---|---|
1000 | task created successfully | Task registered; begin polling (timeWait > 0) |
1001 | work not finish. | Still processing — wait timeWait ms and poll again |
1004 | file already exist. | Source filename conflict (intermediate state) |
1005 | Work Finish | Export completed successfully (terminal, timeWait = 0) |
1017 | add user task fail. | Internal error creating the export job; retry |
1018 | the request param abnormal. | A required field is missing or invalid |
1019 | init aws s3 sdk failed, please contact TVU Support. | Destination storage credentials are invalid or unreachable |
1020 | tvu264 some error. | Video transcoding process failed |
1021 | upload file fail | Failed to upload the output file to cloud storage |
1026 | file restore error. | Source file is archived (Glacier); restore timed out |
1031 | video export time exceeds limit. | System-wide concurrent export quota reached; try later |
1032 | the number of user max export task exceeds limit. | This user has too many concurrent export jobs |
1035 | open or create file fail. | Server failed to open the output file for writing |
1042 | consume memory task num exceeds limit. | Server memory task limit reached; try later |
1046 | insufficient remaining free space | Server disk is full; contact TVU Support |
1050 | (locate source failed) | Cannot locate source TS segments for the requested time range |
1051 | (download temp ts error) | Failed to download temporary TS segments |
1052 | (exceed duration limit) | Clip duration exceeds the allowed maximum |
1053 | (metadata json error) | Failed to generate companion metadata JSON (withMetadataJson=true) |
1084 | from redis get user task fail. | Cache lookup failed; retry after a moment |
1086 | get source ts signature url fail. | Failed to generate a signed URL for the source media |
1093 | verify required ts fail. | Source TS file integrity check failed |
1099 | Media processing encountered an exception. Please retry... | Unexpected processing error; retry, then contact TVU Support |
1100 | export file already existed. | Output file exists and isCover was not set to true |
Request
Header Params
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.tvunetworks.com/export' \
--header 'SID: 92575d36dcb631ac94745e6b157de17a5a13d65b31e44869f06854ab928dd80235d4daae8696b4a92a7be5f802c45a219648701fc9ca59f44e9c0f022d5d38a7' \
--header 'Content-Type: application/json' \
--data-raw '{
"highResolutionMediaFilePath": "https://mma-video-new.s3.us-east-1.amazonaws.com/ts/PRODUCER_RECORDINGS/source-001/live-001/1/play.m3u8",
"startTime": 1700000000000,
"duration": 30000,
"userAccount": "user@example.com",
"fileName": "clip_20231114_30s",
"fileType": "mp4",
"isDryrun": false,
"destination": {
"cloudVendor": "s3",
"bucket": "media-export-bucket",
"region": "us-east-1",
"folder": "export/"
}
}'Response Response Example
Export complete
{
"errorCode": 1005,
"errorMsg": "Work Finish",
"isDryrun": false,
"timeWait": 0,
"videoPath": "https://media-export-bucket.s3.us-east-1.amazonaws.com/export/clip_20231114_30s.mp4",
"fileSize": 52428800,
"videoDuration": 30000,
"thumbnailInfo": {
"url": "https://mma-video-new.s3.us-east-1.amazonaws.com/ts/PRODUCER_RECORDINGS/source-001/live-001/source-001_live-001_1700000000000_30000.jpg",
"width": "1920",
"height": "1080"
},
"videoInfo": {
"url": "https://media-export-bucket.s3.us-east-1.amazonaws.com/export/clip_20231114_30s.mp4",
"type": "mp4",
"bitrate": "5000k",
"width": "1920",
"height": "1080",
"framerate": "29.97",
"duration": "30"
}
}Modified at 2026-06-15 13:53:30