最終更新日:2023-02-28 11:58:45
このインターフェイスを使用すると、クラウドVoDで1つ以上の動画のトランスコードを実行できます。
- このAPIのレスポンスは、リクエストが成功したかどうかのみを示します。実際のトランスコード結果は、API「Video Transcoding Callback」を介して取得する必要があります。
- トランスコードされている動画のトランスコードはサポートされていません。
- トランスコード完了後にソース映像ファイルを削除するように設定している場合、映像を再度トランスコードすることはできません。
- すでにトランスコードされている動画をトランスコードすると、トランスコードされた動画は新たにトランスコードされた動画に置き換えられます。
- トランスコード状態で動画がスタックする場合、クラウド動画の技術スタッフに処理を依頼してください。
リクエスト方法 | 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 | videoIds には「,」のみを含めることはできません。 |
1543 | 透かしテンプレート名が長すぎます |
1544 | トランスコードテンプレート名が長すぎます |
1545 | VideoIds は存在しません。または、動画にアクセスする権限がありません。 |
1546 | 透かしテンプレートは存在しません |
1547 | トランスコードテンプレートは存在しません |
1549 | VideoIds には非アクティブな動画 ID が含まれます |
1551 | デフォルトのトランスコードテンプレートはありません |
1636 | videoIds のソース動画ファイルの一部がありません。 |