Video Transcoding

最終更新日:2023-02-28 11:58:45

説明

このインターフェイスを使用すると、クラウドVoDで1つ以上の動画のトランスコードを実行できます。

  1. このAPIのレスポンスは、リクエストが成功したかどうかのみを示します。実際のトランスコード結果は、API「Video Transcoding Callback」を介して取得する必要があります。
  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 videoIds には「,」のみを含めることはできません。
1543 透かしテンプレート名が長すぎます
1544 トランスコードテンプレート名が長すぎます
1545 VideoIds は存在しません。または、動画にアクセスする権限がありません。
1546 透かしテンプレートは存在しません
1547 トランスコードテンプレートは存在しません
1549 VideoIds には非アクティブな動画 ID が含まれます
1551 デフォルトのトランスコードテンプレートはありません
1636 videoIds のソース動画ファイルの一部がありません。