트랜스코딩 & 패키징 에러 코드

트랜스코딩 & 패키징 (T&P) 서비스와 관련한 각종 에러 코드에 대해 설명합니다.

작업/태스크 용어 정의

  • 작업: 작업은 T&P 서비스에서 트랜스코딩 및 포렌식 워터마킹 전처리 또는 DRM 패키징을 처리하는 과정을 의미합니다. 하나의 작업은 여러 태스크로 구성됩니다.
  • 태스크: 태스크는 작업의 하위 개념으로, 하나의 작업은 다음과 같은 여러 태스크로 이루어집니다.
    • 태스크 1 - 준비 (작업 유형 확인, 작업 생성 및 원본 파일 분석)
    • 태스크 2 - 트랜스코딩 (작업 유형에 포렌식 워터마킹이 포함된 경우, 트랜스코딩 태스크에 워터마크 전처리 과정 추가)
    • 태스크 3 - 세그먼테이션 및 패키징 (트랜스코딩 결과물을 DASH/HLS 형식으로 패키징. 작업 설정에 따라 멀티 DRM 암호화 적용)
    • 태스크 4 - 결과 파일 복사 (고객사의 S3 저장소에 작업 결과물 업로드)

태스크 상태 코드

각각의 태스크는 아래와 같은 상태 코드 중 하나를 리턴합니다.

상태 코드 상태
TP000 준비
TP100100 트랜스코딩
TP100200 트랜스코딩 완료
TP200100 패키징 준비
TP200200 패키징 준비 완료
TP300100 세그먼팅
TP300200 세그먼팅 완료
TP400100 사용자 버킷으로 복사
TP500 작업 완료
TP600 에러
TP700100 중지 요청됨
TP700200 중지됨

에러 코드

각 태스크 단계 별 에러 코드와 상세 설명을 안내합니다.

태스크 1: 준비

작업 생성 프로세스의 첫 번째 단계는 작업 실패를 방지하기 위해 서비스, 소스 비디오 파일 유형 및 스토리지와 관련하여 다양한 유형의 검사가 수행되는 준비 태스크입니다.

작업 등록 관련 에러

작업 유형 및 서비스 플랜과 관련된 에러 코드입니다.

에러 코드 에러 메시지 해결 방안
E5001 DRM 서비스가 활성화되어 있지 않음 DRM 적용을 위해서는 해당 서비스 플랜에 가입해야 합니다.
E2000 작업 생성 실패 재시도 시에도 동일 에러 발생 시, 헬프데스크로 문의해 주시기 바랍니다.
E2001 트랜스코딩 정보를 찾을 수 없음 API 요청 데이터에 트랜스코딩 관련 정보가 입력되어 있는지 확인합니다.
E2002 입력 스토리지 정보를 찾을 수 없음 API 요청 데이터에 job.input.storage_id 항목이 입력되어 있는지 확인합니다.
E2003 스토리지 리전 정보가 잘못됨 콘솔에서 설정한 서비스 리전과 스토리지의 리전이 일치하는지 확인합니다.
E2004 입력 파일을 찾을 수 없음 S3 파일 경로는 대소문자를 구분합니다. 입력 파일의 경로가 정확하게 설정 되었는지 확인합니다.
E2005 포렌식 워터마킹 키 생성 실패 재시도 시에도 동일 에러 발생 시, 헬프데스크로 문의해 주시기 바랍니다.
E2006 트랜스코딩 요청 토큰 생성 샐패 재시도 시에도 동일 에러 발생 시, 헬프데스크로 문의해 주시기 바랍니다.
E2008 작업 목록 조회 실패 설정 확인 후 재시도 시에도 동일 에러 발생 시, 헬프데스크로 문의해 주시기 바랍니다.
E2009 작업 조회 실패 설정 확인 후 재시도 시에도 동일 에러 발생 시, 헬프데스크로 문의해 주시기 바랍니다.
E2010 작업 중지 실패 재시도 시에도 동일 에러 발생 시, 헬프데스크로 문의해 주시기 바랍니다.
E2011 내부 API 호출 실패 설정 확인 후 재시도 시에도 동일 에러 발생 시, 헬프데스크로 문의해 주시기 바랍니다.
E2014 잘못된 상태 코드 요청됨 정확한 작업 상태 코드로 재요청합니다.
E2015 잘못된 작업 ID 요청됨 정확한 작업 ID로 재요청합니다.
E2019 현재 작업을 재시작할 수 없음 작업 중지 후 재시작 합니다.
E2020 작업 생성 요청 데이터가 잘못됨 해당 API 요청 데이터 확인 후 재시도합니다.
E2021 비디오 스펙 정보를 찾을 수 없음 작업 재시작 시, 작업 ID와 저장소의 입력 파일을 확인합니다.
E2135 output.transcodings.track_id 중복 output.transcodings.track_id 는 고유한 값을 입력 합니다.
E2136 output.transcodings.sources 가 잘못됨 output.transcodings.sources는 빈값을 입력 하지 않습니다.
E2137 output.transcodings.sources 가 여러개 입력됨 output.transcodings.sources는 1 track 당 1개씩 입력 합니다.
E2138 Input.audios[].remap.track 값이 중복 Input.audios[].remap.track 값에 입력된 index를 중첩되지 않게 입력 합니다.
E2139 input.audios[].remap.track, output.transcodings.sources.track 매칭 실패 input.audios[].remap.track 에 입력한 index 가 output.transcodings.sources.track 에 전부 입력 하였는지 확인합니다.
E2145 vbr 입력 시 bitrate 옵션 설정이 잘못됨 bitrate_modevbr 입력 한 경우, crf 또는 min_bitrate 또는 max_bitrate 중 한개는 반드시 입력합니다.
E2146 crf 옵션 범위가 잘못됨 bitrate_modevbr 입력 하고 crf 값 입력 시 crf 값은 [0~69]로 입력 가능합니다.
E2147 min_bitrate 값이 잘못됨 min_bitrate 는 [10 kbps ~ 100 Mbps] 범위만 지원합니다.
E2148 max_bitrate 값이 잘못됨 max_bitrate 는 [10 kbps ~ 100 Mbps] 범위만 지원합니다.
E2149 crf, bitrate 동시 사용됨 crf 와 bitrate 중 한가지 옵션만 입력 합니다.
E2150 crf 옵션 사용 불가 bitrate_modecbr 입력 한 경우, crf 는 사용이 불가능합니다. crf 옵션은 오직 vbr에서만 사용 가능합니다.
E2151 bitrate 옵션이 잘못됨 bitrate_modecbr 입력 한 경우, min_bitrate, max_bitrate 는 사용이 불가능합니다. bitrate 옵션을 사용합니다.
E4007 dash, hls, cmaf 중 한가지는 설정하여야 합니다.
E4012 cmaf은 다른 스트리밍 포멧과 같이 요청할 수 없습니다. cmaf은 dash, hls 형식을 전부 지원하는 포멧이기 때문에 dash 와 hls를 추가로 설정하지 않습니다. cmaf을 true로 설정하였을 경우, dash 와 hls 설정 값을 false로 설정 합니다.
E5002 포렌식 워터마킹 서비스가 활성화되어 있지 않음 포렌식 워터마킹 적용을 위해서는 해당 서비스 플랜에 가입해야 합니다.
E5003 T&P 서비스가 활성화되어 있지 않음 트랜스코딩&패키징 서비스를 이용하려면 헬프데스크로 문의하시기 바랍니다.
E5004 DRM 또는 FWM 서비스가 활성화되어 있지 않음 가입한 PallyCon 서비스 플랜을 확인하고 이상이 있다면 헬프데스크로 문의합니다.
E5005 오디오 트랙 제한 초과 트라이얼 계정은 멀티 오디오 트랙을 지원하지 않습니다. 하나의 오디오 트랙만 입력하거나 상용 플랜으로 전환합니다.
E5006 리전 정보 누락 API 요청 데이터에 리전 정보가 정확히 입력되었는지 확인합니다.
E5007 상용 계정에 지원되는 리전이 아님 다음 리전 중 하나를 이용합니다.
- OREGON(“RG004”, “Oregon”, “us-west-2”)
- SEOUL(“RG011”, “Seoul”, “ap-northeast-2”)
- SINGAPORE(“RG013”, “Singapore”, “ap-southeast-1”)
E5008 트라이얼에 지원되는 리전이 아님 평가판 계정에 지원되는 오레곤, 서울 또는 싱가포르 리전을 사용합니다.

원본 파일 분석 관련 에러

에러 코드 에러 메시지 해결 방안
E2100 입력 파일 분석 실패 MediaInfo 라이브러리에서 에러가 발생하였습니다. 재시도 시에도 동일 에러 발생 시, 헬프데스크로 문의해 주시기 바랍니다.
E2101 영상 프레임레이트가 잘못됨 다음 중 하나의 프레임레이트로 인코딩된 영상을 이용합니다. [23.98 , 24.0 , 25.0 , 29.97 , 30.0]
E2102 영상 높이 확인 실패 입력 파일 확인 후 재시도합니다.
E2103 영상 너비 확인 실패 입력 파일 확인 후 재시도합니다.
E2104 영상 높이 정보가 잘못됨 영상 높이(해상도)는 짝수여야 합니다.
E2105 영상 너비 정보가 잘못됨 영상 너비(해상도)는 짝수여야 합니다.
E2106 화면 비율이 잘못됨 영상 가로 세로 비율은 16:9이어야 합니다.
E2107 비디오 비트레이트가 잘못됨 비디오 비트레이트는 [10 kbps ~ 100 Mbps] 범위만 지원합니다.
E2108 오디오 비트레이트가 잘못됨 오디오 비트레이트는 다음 목록 중 하나만 지원합니다. [32, 64, 96, 128, 160, 192, 224, 256]
E2109 영상 높이 제한 초과 (트라이얼) 트라이얼 계정은 1080 이하의 영상 높이만 지원됩니다.
E2110 자막 파일 개수 제한 초과 최대 10개까지의 자막 파일 입력만 지원됩니다.
E2113 영상 길이 제한 초과 (트라이얼) 트라이얼 계정은 최대 10분까지의 영상만 지원됩니다.
E2114 동영상 콘테이너 제한 (트라이얼) 트라이얼 계정은 MPEG-4 콘테이너만 지원됩니다.
E2115 오디오 코덱 제한 (트라이얼) 트라이얼 계정은 AAC 오디오 코덱만 지원합니다.
E2116 지원하지 않는 비디오 코덱 AV1 비디오 코덱은 지원하지 않습니다.
E2117 출력 비디오 코덱 설정 누락됨 API 요청 데이터에 출력 비디오 코덱이 설정되어 있는지 확인합니다.
E2118 요청된 트랜스코딩 비디오 코덱 불일치 입력 콘텐츠의 코덱과 출력될 결과물의 코덱 설정을 확인합니다.
E2119 지원되지 않는 출력 비디오 코덱 출력될 결과물의 비디오 코덱은 H.264 또는 H.265 만 지원됩니다.
E2120 비디오 트랜스코딩 해상도 제한 초과 H.264 코덱은 최대 6개, H.265 코덱은 최대 3개까지의 비디오 트랜스코딩 해상도를 지원합니다.
E2121 코덱 지원 제한 (트라이얼) 트라이얼 계정은 포렌식 워터마킹 적용 시 H.264 코덱만 지원됩니다.
E2122 영상 높이 최소값 제한 영상 높이(해상도)는 234 이상이어야 합니다.
E2123 영상 높이 최대값 제한 영상 높이(해상도)는 2160 이하이여야 합니다.
E2124 FWM 작업에 지원되지 않는 코덱 FWM 작업 유형은 H.264 또는 H.265 코덱만 지원됩니다.
E2125 FWM 작업에 지원되지 않는 콘테이너 FWM 작업 유형은 MPEG-4 콘테이너만 지원됩니다.
E2126 지원되지 않는 자막 포맷 자막 포맷은 WebVTT만 지원됩니다.
E2127 VFR 콘텐츠 미지원 Variable Frame Rate(VFR) 콘텐츠는 지원하지 않습니다. Constant Frame Rate(CFR) 형태의 입력 콘텐츠를 사용해야 합니다.
E2128 프레임레이트 확인 실패 입력 콘텐츠의 프레임레이트 정보를 확인할 수 없습니다. 입력 파일이 정상적인 CFR 콘텐츠인지 확인합니다.
E2129 비트레이트 정보가 잘못됨 API 요청 데이터에 output.transcodings[].bitrate 항목이 입력되어 있는지 확인합니다.
E3003 비디오 트랙 정보 확인 불가 입력 파일의 비디오 트랙 정보가 정상적인지 확인합니다.
E3004 비디오 트랙 제한 초과 입력된 영상 파일의 비디오 트랙이 하나 이상인지 확인합니다.
E3005 미디어 정보 프로그램 미설치 내부 오류입니다. 헬프데스크로 문의하시기 바랍니다.
E9010 지원하지 않는 출력 코덱 (트라이얼) 트라이얼 계정은 H.264 코덱만 지원됩니다.
E9011 패키징 수 제한 초과 (트라이얼) 트라이얼 계정은 최대 2개의 패키징 작업만 지원됩니다. 추가 트라이얼을 원하는 경우 헬프데스크로 문의하시기 바랍니다.
E9012 트랜스코딩 출력 수 제한 초과 (트라이얼) 트라이얼 계정은 최대 2개의 트랜스코딩 출력만 지원됩니다. 추가 트라이얼을 원하는 경우 헬프데스크로 문의하시기 바랍니다.
E9013 자막 입력 제한 (트라이얼) 트라이얼 계정은 자막 입력을 지원하지 않습니다. 자막을 포함한 패키징이 필요한 경우 상용 플랜으로 전환하시기 바랍니다.

스토리지 관련 에러

에러 코드 에러 메시지 원인 해결 방안
E3000 잘못된 스토리지 ID API 요청 시 등록되지 않은 스토리지 ID가 입력된 경우 발생합니다. 요청 데이터 확인 후 재시도 시에도 동일 에러 발생 시, 헬프데스크로 문의해 주시기 바랍니다.
E3001 스토리지 목록 조회 실패 요청 데이터 오류 또는 네트워크 오류 요청 데이터 확인 후 재시도 시에도 동일 에러 발생 시, 헬프데스크로 문의해 주시기 바랍니다.
E3002 삭제할 스토리지 ID가 잘못됨 스토리지 삭제 요청 시, 등록되지 않은 스토리지 ID가 입력됨 요청 데이터 확인 후 재시도 시에도 동일 에러 발생 시, 헬프데스크로 문의해 주시기 바랍니다.
E3007 스토리지 정보 업데이트 실패 내부 서버 오류 또는 네트워크 오류 요청 데이터 확인 후 재시도 시에도 동일 에러 발생 시, 헬프데스크로 문의해 주시기 바랍니다.
E3008 오디오 트랙 정보를 찾을 수 없음 입력 파일에 오디오 트랙이 누락됨 입력 파일 확인 후 재시도합니다.
Amazon S3 관련 에러
에러 코드 에러 메시지 해결 방안
E4010 S3 버킷 접근 실패 S3 접근을 위한 액세스 키와 비밀 키가 정확히 입력 되었는지 확인합니다. 서비스 설정과 S3 스토리지의 리전이 일치하는지 확인합니다.
E4009 S3 버킷을 찾을 수 없음 입력한 S3 버킷이 존재하는지 확인합니다.
E8003 기타 AWS 관련 오류 AWS 내부 네트워크 또는 시스템 오류가 발생하였습니다.

태스크 2: 트랜스코딩

에러 코드 에러 메시지
E7001
E2007
트랜스코딩 태스크 실패

태스크 3: 세그멘테이션 및 패키징

패키징 작업 관련 에러

아래 에러 코드 중 해결 방안이 명시되어 있지 않은 항목들은 고객사에서 직접 해결할 수 없는 에러입니다. 해당 에러 발생 시에는 헬프데스크를 통해 문의해 주시기 바랍니다.

에러 코드 상태 원인 해결 방안
E8003 세그먼팅 준비 실패 Amazon S3 관련 에러 참고 헬프데스크로 문의
E8005 세그먼팅 및 DRM 패키징 실패 세그먼팅과 DRM 패키징 과정에서 내부 에러 발생함 작업 재시도 시에도 동일 에러 발생 시 헬프데스크로 문의합니다.
E9998 지원되지 않는 요청 방식 HTTP 방식 API 요청은 지원되지 않음 API 요청 규격 확인 후 재시도합니다.
E9999 잘못된 작업 작업 재시도 시에도 동일 에러 발생 시 헬프데스크로 문의합니다.

패키징 API 관련 에러

에러 코드 에러 메시지 해결 방안
0000 API 응답 성공
E1003 파라미터 입력값이 잘못됨 API 요청 규격 확인 후 재시도합니다.
E9000 Authorization 헤더를 찾을 수 없음 API 인증 관련 규격 확인 후 재시도합니다.
E9001 인증 토큰 값이 잘못됨 API 인증 관련 규격 확인 후 재시도합니다.
E9002 토큰 페이로드 값이 잘못됨 API 인증 관련 규격 확인 후 재시도합니다.
E9006 API 이용 권한 없음 재시도 시에도 동일 에러 발생 시 헬프데스크로 문의합니다.
E9008 계정 정보를 찾을 수 없음 재시도 시에도 동일 에러 발생 시 헬프데스크로 문의합니다.
E9014 해당 사이트 ID에 대한 권한이 없음 재시도 시에도 동일 에러 발생 시 헬프데스크로 문의합니다.

태스크 4: 결과 파일 복사

에러 코드 에러 메시지 해결 방안
E8007 고객사 S3에 결과 파일 복사 실패 작업 재시도 시에도 동일 에러 발생 시 헬프데스크로 문의합니다.
이전