최신 업데이트:2023-02-28 11:58:45
이 인터페이스를 사용하여 클라우드 VoD에 있는 하나 이상의 비디오에 대한 트랜스코딩을 수행할 수 있습니다.
- 이 API의 응답은 요청의 성공 여부만 표시합니다. 실제 트랜스코딩 결과는 API “비디오 트랜스코딩 콜백”을 통해 가져와야 합니다.
- 트랜스코딩 중인 비디오는 트랜스코딩을 지원하지 않습니다.
- 소스 비디오 파일이 트랜스코딩이 완료된 후 삭제되도록 설정되면 비디오를 다시 트랜스코딩할 수 없습니다.
- 이미 트랜스코딩된 비디오를 트랜스코딩하면 트랜스코딩된 비디오가 새로 트랜스코딩된 비디오로 대체됩니다.
- 비디오가 트랜스코딩 상태에서 멈추면 클라우드 비디오 기술 직원에게 문의하여 처리합니다.
요청 방식 | 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의 쿨한 비디오 파일이 없습니다 |