Video Transcoding

최신 업데이트:2023-02-28 11:58:45

설명

이 인터페이스를 사용하여 클라우드 VoD에 있는 하나 이상의 비디오에 대한 트랜스코딩을 수행할 수 있습니다.

  1. 이 API의 응답은 요청의 성공 여부만 표시합니다. 실제 트랜스코딩 결과는 API “비디오 트랜스코딩 콜백”을 통해 가져와야 합니다.
  2. 트랜스코딩 중인 비디오는 트랜스코딩을 지원하지 않습니다.
  3. 소스 비디오 파일이 트랜스코딩이 완료된 후 삭제되도록 설정되면 비디오를 다시 트랜스코딩할 수 없습니다.
  4. 이미 트랜스코딩된 비디오를 트랜스코딩하면 트랜스코딩된 비디오가 새로 트랜스코딩된 비디오로 대체됩니다.
  5. 비디오가 트랜스코딩 상태에서 멈추면 클라우드 비디오 기술 직원에게 문의하여 처리합니다.

요청 설명

요청 방식 POST/GET
API 인터페이스 주소 https://api.cloudv.haplat.net/vod/videoManage/transCode
인증 필요

요청 파라미터

파라미터 유형 필수 여부 설명
videoId string 비디오 ID, 여러 ID는 “,”로 구분합니다.
waterMarkTemplateName string 아니 워터마크 템플릿 이름, 기본적으로 워터마크는 추가되지 않습니다, 클라우드 VoD 플랫폼에서 템플릿을 선택하여 비디오에 워터마크를 추가할 수 있습니다.
transCodeTemplateName string 아니 트랜스코딩 템플릿 이름, 지정하지 않으면 기본 트랜스코딩 템플릿이 사용됩니다.
watermarkTemplateId string 아니 워터마크 템플릿 ID, 기본적으로 워터마크가 추가되어 있지 않습니다. 비디오에 워터마크를 추가할 템플릿을 선택할 수 있습니다.
transCodeTemplateId string 아니 트랜스코딩 조합 템플릿 ID, 지정하지 않으면 기본 트랜스코딩 템플릿이 사용됩니다.

반환 파라미터

일반적인 응답은 일반적인 응답 을 참조하십시오.

예시

입력 예

curl -X POST 
  http://api.cloudv.haplat.net/vod/videoManage/transCode 
  -H 'content-type: application/x-www-form-urlencoded; charset=utf-8' 
  -H "Authorization: your token" 
  -H "X-WS-Timestamp: current timestamp" 
  -H "X-WS-AccessKey: your AccessKey ID"
  -d 'videoIds=9bac2161015d10003fdae81b00000000%2C9ba11ae7015d1000503692a400000000&waterMarkTemplateName=%E5%85%83%E6%97%A6%E6%B0%B4%E5%8D%B0&transCodeTemplateName=%E6%B5%8B%E8%AF%95%E8%BD%AC%E7%A0%810&subtitleId=2e5359cf016a10001e638de000000000'

오류 코드

다음 오류 코드는 비디오 업로드 토큰 가져오기 요청 전용입니다. 일반적인 오류는 일반적인 응답 을 참조하십시오.

오류 코드 설명
1540 videoId는 비워 둘 수 없습니다
1541 videoIds에 특수 문자가 포함되어 있습니다
1542 videoId는 “,”만 포함할 수 없습니다
1543 워터마크 템플릿 이름이 너무 깁니다.
1544 트랜스코딩 템플릿 이름이 너무 깁니다.
1545 VideoId가 존재하지 않습니다! 또는 비디오에 접근할 수 있는 권한이 없습니다!
1546 워터마크 템플릿이 존재하지 않습니다
1547 트랜스코딩 템플릿이 존재하지 않습니다
1549 VideoId에는 비활성 비디오 ID가 포함되어 있습니다
1551 기본 트랜스코딩 템플릿이 없습니다
1636 일부 videoIds의 쿨한 비디오 파일이 없습니다
이 문서의 내용이 도움이 되었습니까?
아니오
정상적으로 제출되었습니다.피드백을 주셔서 감사합니다.앞으로도 개선을 위해 노력하겠습니다.