Transcoding & Packaging Error Codes
This document describes various error codes related to Transcoding & Packaging service.
Jobs And Tasks Terminology Description
Job: Job tells T&P-API how to execute transcode and Forensic Watermark preprocessing or DRM packaging. A job is consist of multiple tasks.Task: Task is a subset of Job . The different tasks involved are as follows:- Task 1 - READY (check job type, creation and a source file analysis)
- Task 2 - TRANSCODING (transcoding task and if the job type has Forensic Watermark, preprocessing is a part of this task.)
- Task 3 - SEGMENTATION AND PACKAGING (packaging the file to DASH or HLS, Multi-DRM is part of this process)
- Task 4 - COPY OUTPUT FILE (upload packaged file to users' S3)
Task Status Codes
Each task may return one of the status codes listed below.
| Status Code | State |
|---|---|
| TP000 | READY |
| TP100100 | TRANSCODING |
| TP100200 | TRANSCODING_COMPLETED |
| TP200100 | PREPARE_FOR_PACKAGING |
| TP200200 | PREPARE_FOR_PACKAGING_COMPLETED |
| TP300100 | SEGMENTING |
| TP300200 | SEGMENTING_COMPLETED |
| TP400100 | COPYING_TO_USER_BUCKET |
| TP500 | COMPLETE |
| TP600 | ERROR |
| TP700100 | STOP_REQUEST |
| TP700200 | STOPPED |
Error Codes
The details of the error codes are listed in the section below.
Task 1: READY
The first step in the Job creation process is the READY task, where different types of checks are conducted with respect to the service, source video file types & storage to avoid any job failures.
Errors about registering T&P jobs
The below errors are related with job type and service plans.
| Error Code | Description | Solution |
|---|---|---|
| E5001 | DRM Service is not Active. | If you want to use DRM please subscribe for the plan |
| E2000 | Failed to create a job. | Retry and contact the help desk if the error persists. |
| E2001 | Could not find transcoding information. | In the API ensure that the following field is not empty output.transcodings[] |
| E2002 | Could not find input storage information. | In the API ensure that the storage field job.input.storage_id is valid |
| E2003 | Invalid region information for storage. | Ensure that the storage requested is in the same region |
| E2004 | Could not find the input file. | File path does not match as S3 is case-sensitive, ensure that the filename case is matching |
| E2005 | Failed to create a forensic watermark key. | Retry and contact the help desk if the error persists. |
| E2006 | Failed to create a transcoding request token. | Retry and contact the help desk if the error persists. |
| E2008 | Failed to get a job list. | Retry with valid parameters and contact the help desk if the error persists. |
| E2009 | Failed to get a job. | Retry with valid parameters and contact the help desk if the error persists. |
| E2010 | Failed to stop my job. | Retry with valid parameters and contact the help desk if the error persists. |
| E2011 | Failed to call internal api. | Retry with valid parameters and contact the help desk if the error persists. |
| E2014 | The requested status code is invalid. | Request with valid job status code. |
| E2015, E2016 | The requested job id is invalid. | Request with valid job id. |
| E2019 | You cannot restart from the current job state. | In order to restart, the job needs to be stopped properly. Ensure that the job is in stop state |
| E2020 | The job create request data is invalid. | Check out the API Request form for Job creation |
| E2021 | No existing video spec information found. | On restarting the job, please check out valid job_id and input file exists on the Storage. |
| E2130 | The Region infromation mismatch | Verify that the region you are using the TNP service in matches the region of the storage entered in your job request. |
| E2135 | Invalid output.transcodings.[].track_id |
output.transcodings.[].track_id must be unique value. |
| E2136 | Invalid output.transcodings.sources |
output.transcodings.sources must be entered. |
| E2137 | Invalid output.transcodings.sources’s count. |
One value must be entered for each output.transcodings.sources. |
| E2138 | input.audios[].remap.track are duplicated. |
Input.audios[].remap.track must be unique value. |
| E2139 | input.audios[].remap.track and output.transcodings.sources.track do not match. |
The value in input.audios[].remap.track must be entered in Output.Transcodings.sources.track. |
| E2145 | Canno use same time crf and min/max_bitrate. | If bitrate_mode is vbr entered, crf or min_bitrate or max_bitrate must be entered. |
| E2146 | Invalid crf | If bitrate_mode is vbr and crf entered, crf value can be [0~69]. |
| E2147 | Invalid Video min_bitrate. | Video min_bitrate must be between [10 kbps ~ 100 Mbps]. |
| E2148 | Invalid Video max_bitrate. | Video max_bitrate must be between [10 kbps ~ 100 Mbps]. |
| E2149 | Cannot use same time crf, bitrate. | The crf and bitrate settings cannot be used together. |
| E2150 | Cannot use crf | If bitrate_mode is cbr entered, crf option is not available. |
| E2151 | Cannot use min/max_bitrate | If bitrate_mode is cbr entered, min_bitrate or max_bitrate options are not available. |
| E2152 | frame_rate value mismatch | If you entered a value for output.transcodings[].frame_rate, you must enter the same value as the frame rate of the input video. |
| E2153 | audio codec value mismatch | If you entered a value for Output.transcodings[].codec when setting up the audio track, you must enter the same value as the codec of the input audio. |
| E2154 | output audio codecs value mistmatch | If you entered multiple Output.transcodings[].codec when setting up audio tracks, make sure they are the same value. |
| E2155 | Unsupported audio codec | Supported audio codec : [aac, ac3, opus, vorbis] |
| E4007 | One of the dash and hls and cmaf must be set. | Set at least one of dash, hls, cmaf to true . |
| E4012 | cmaf and other streaming formats cannot be requested at the same time. | Since cmaf is a format that supports both dash and hls formats, dash and hls are not additionally set. If cmaf is set to true, dash and hls setting values are set to false |
| E5001 | DRM Service is not active | If DRM is required please enable the service. |
| E5002 | Forensic watermark Service is not active | If Forensic watermark is required please enable the service. |
| E5003 | Optional Service For T&P is not enabled. | Please contact our help desk to activate the T&P service |
| E5004 | At least ONE service is enabled in (DRM / FWM). | Check User’s Service Status with respect to DRM / FWM, and if neither is in service, contact our help desk. |
| E5005 | Audio track must be only 1. Multi Audio tracks are not supported on trial. | If you want to use Multi Audio Tracks, upgrade to commercial plan |
| E5006 | Region must be included to register T&P Job. | Only reported while using API based bad requests, not applicable while using console. |
| E5007 | Region should be in [RG004, RG011, RG013] | * OREGON(“RG004”, “Oregon”, “us-west-2”) * SEOUL(“RG011”, “Seoul”, “ap-northeast-2”) * SINGAPORE(“RG013”, “Singapore”, “ap-southeast-1”) |
| E5008 | Region should be in [RG004, RG011, RG013] | The regions supported are Oregon, Seoul and Singapore. |
Analysis of a source file
| Error Code | Description | Solution |
|---|---|---|
| E2100 | Fail to inspect input files | MediaInfo library error. retry and contact the help desk if error persists |
| E2101 | Video Frame Rate in invalid | Video Frame Rate must be in [23.98 , 24.0 , 25.0 , 29.97 , 30.0] |
| E2102 | Cannot find height of Video | Check the video file and retry again |
| E2103 | Cannot find width of Video | Check the video file and retry again |
| E2104 | Invalid height of Video. height must be even number | height must be even number |
| E2105 | Invalid width of Video. width must be even number | width must be even number |
| E2106 | Invalid ratio of height and width. | The ratio of height and width must be [W:H = 16:9] |
| E2107 | Invalid Video bitrate. | Video bitrate must be between [10 kbps ~ 100 Mbps] |
| E2108 | Invalid Audio bitrate. | Audio bitrate must be in as mentioned in list [32, 64, 96, 128, 160, 192, 224, 256] |
| E2109 | Invalid Video height. | For Trial, Video height should be under [ ~ 1080 ] |
| E2110 | The Number of Subtitles cannot exceed 10. | Ensure that the Number of Subtitles is under 10. |
| E2113 | Trial Video duration cannot exceed 10 min. | For Trial Video duration cannot exceed 10 min. |
| E2114 | Trial Video container is [MPEG-4] | Trial Video container is [MPEG-4] |
| E2115 | Trial Audio codec is [AAC] | Trial Audio codec is [AAC] |
| E2116 | Video Codec invalid | Video Codec [AV1] is not supported. |
| E2117 | Video Codec cannot be empty | Output Video Codec cannot be empty. Ensure valid codec is mentioned in API |
| E2118 | Requested Transcoding Video Codecs must be consistent. | Output Video Codec should be 1. check out the input video’s media info. |
| E2119 | Requested Transcoding Video Codecs must be in [h264 or h265]. | The output Video Codecs supports only [h264 or h265]. |
| E2120 | Maximum Transcoding Video Codec Resolution reached | The Maximum Transcoding Video Codec Resolution limit is [6] for h264 Codec / [3] for h265 Codec. |
| E2121 | Invalid codec | For Trial account, Video codec for FWM should be [h264] |
| E2122 | Invalid video height, Video height less than minimum limit | Video height should be greater than 234 |
| E2123 | Invalid video height, Video height more than maximum limit | Video height should be less than 2160 |
| E2124 | Invalid video codec for FWM job | For job type FWM, Input Video codec should be [h264, h265] |
| E2125 | Invalid container for FWM | For job type FWM, Input container should be [MPEG-4] |
| E2126 | Invalid container for Subtitle | To add Subtitles, only supported [webvtt] container format. |
| E2127 | Variable frame rates(VFR) content is not supported. | Change the input content’s frame rate from [VFR] to [CFR]. CFR : Constant Frame Rate |
| E2128 | Frame rate mode check is not possible. | Input content’s frame rate should not be null. CFR(Constant Frame Rate) is only supported. |
| E2129 | Bitrate is Required. | Ensure Video Bitrate filed is not empty in the API output.transcodings[].bitrate |
| E3003 | Could not find video track information. | The requested input content does not have Video Track. check out the input video’s media info. |
| E3004 | This file has too many Video tracks. | Please check the input video and ensure there is only 1 video codec |
| E3005 | Media check program is not installed. | Internal Error contact help desk |
| E9010 | Invalid output codec | For Trial, output codec should be h264. |
| E9011 | Trial packaging limit exceeded. : 2 | For Trial, request for T&P job limitation is [2]. Please contact help desk support if the limit is reached. |
| E9012 | Trial video output count limit exceeded. : 2 | For Trial, output transcoding video count limit is 2. Please contact help desk support if the limit is reached. |
| E9013 | Trial users are not allowed to input subtitles or captions | For Trial, subtitles not supported, upgrade for commercial plans if want to add subtitles or captions. |
T&P Storage
| Error Code | Description | Cause | Solution |
|---|---|---|---|
| E3000 | Request storage id is invalid. | The storage_id not registered. Only appears in API based bad requests, not for the console users. | Retry with proper values and contact the help desk if the error persists. |
| E3001 | Fail to get a storage list. | the requests to get lists do not match or connection error. | Retry with valid requests and contact the help desk if the error persists. |
| E3002 | Invalid storage ID included. | On deletion, the requested Storage does not exist. | Ensure the storage ID is present, retry and contact the help desk if the error persists. |
| E3007 | Failed to update storage information. | Internal server error- connection error. | Retry with valid requests and contact the help desk if the error persists. |
| E3008 | Could not find audio track information. | The file does not have an audio track. | Please provide a valid file with Audio and retry, contact the help desk if the error persists. |
AWS S3 error
| Error Code | Description | Solution |
|---|---|---|
| E4010 | S3 bucket Access Denied | * Check if access key and secret key for S3 access are entered correctly * Check that the service region of the forensic watermarking settings matches the AWS region of S3 |
| E4009 | S3 Bucket not found | Check if the S3 bucket actually exists |
| E8003 | Other AWS related Exception | This is caused by AWS network connection error or other external infra causes. |
Task 2: TRANSCODING
| Error Code | Description |
|---|---|
| E7001 E2007 |
Transcoding task Failure |
Task 3: SEGMENTATION AND PACKAGING
Packaging job error codes
Among the error codes below, the items for which solutions are not specified are errors that the customer cannot directly solve. In case of those errors, please contact us through the Helpdesk.
During success the code returned would be 0000.
| Error Code | State | Cause | Solution |
|---|---|---|---|
| E8003 | Failed to get prepared for segmenting. | see the table of AWS S3 related error | contact help desk |
| E8005 | Failed segmenting and DRM packaging | occurs when step4- segmenting and DRM packaging | Retry the packaging job operation and contact the help desk if the error persists. |
| E9998 | Request Method ‘{httpMethod}’ not supported. | request http method is not supported in this api path. | Check the API request format. |
| E9999 | Invalid operation | Retry and Please contact the help desk if error persists |
Packaging related API specific error codes
| Error Code | Description | Solution |
|---|---|---|
| 0000 | API response success | |
| E1003 | The parameter value is invalid. | Check our document for required parameters. |
| E2026 | The job is already finished. | It’s already done and can’t be stopped. |
| E4013 | Invalid streaming_format | The streaming_format entered in the colour condition is an unsupported type. Supported search terms : dash, hls, cmaf |
| E5011 | Cannot change regions when there is a job in progress. | Change the region when you’re done with packaging in progress. |
| E9000 | Can’t find authorization header. | Check out our authentication process docs. |
| E9001 | Token value is invalid. | Check out our authentication process docs. |
| E9002 | Token payload value is invalid. | Check out our authentication process docs. |
| E9003 | Token is expired. | Check the token validity time and regenerate it. |
| E9006 | You do not have permission for this API. | Retry and contact the help desk if the error persists. |
| E9008 | Account information not available. | Retry and contact the help desk if the error persists. |
| E9014 | You do not have permission for this site id. | Retry and contact the help desk if the error persists. |
Task 4: COPY OUTPUT FILE
| Error Code | Description | Solution |
|---|---|---|
| E8007 | Failed to copy packaged files to User’s S3. | Retry the packaging job operation and contact the help desk if the error persists. |