アニメーション画像ジョブを送信し、非同期処理を開始します。

注
  • 動画の一部をキャプチャしてアニメーション画像を生成できるのは、動画がUploadSucces、Transcoding、Normal、Checking、またはBlocked状態の場合のみです。
  • 動画の生成料金は、動画のトランスコード料金に含まれています。 両方のサービスは、解決と期間によって課金されます。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター データ型 必須／任意 例 説明
操作 String 必須 SubmitDynamicImageJob

実行したい操作。 値をSubmitDynamicImageJobに設定します。

DynamicImageTemplateId String 必須 1a443dc52e ***** f10abc4794d70

アニメーション画像テンプレートのID。
VideoId String 必須 7d2fbc3e273441 ***** bdb0e08e55f

ビデオのID。
OverrideParams String 任意 {"透かし":[{"コンテンツ":"ユーザーID: 66666","WatermarkId":"8ca03c884944bd0 ***** 5efccc312367"}]}

オーバーライドに使用されるパラメーター。 値は JSON 形式の文字列です。 詳細については、「メディア処理パラメーター」トピックの「OverrideParams」セクションを参照してください。 パラメータは、アニメーション画像テンプレート内のパラメータを置き換えるために使用される。 詳細については、「基本データ型」トピックをご参照ください。

レスポンスパラメーター

パラメーター データ型 例 説明
DynamicImageJob Struct

アニメーション画像ジョブに関する情報。
JobId String ad90a501b1b ***** fb72374ad005046

アニメーション画像ジョブのID。
RequestId String 25818875-5F78 ***** BEF6-D7393642CA58

リクエストの ID です。

例

リクエストの例

https:// vod.{ApiRegio n}.aliyuncs.com/?Action=SubmitDynamicImageJob
&DynamicImageTemplateId=1a443dc52e ***** f10abc4794d70
&VideoId=7d2fbc3e273441 ***** bdb0e08e55f
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式 

<SubmitDynamicImageJobResponse>
      <RequestId>25818875-5F78 ***** BEF6-D7393642CA58</RequestId>
      <DynamicImageJob>
            <JobId>ad90a501b1b ***** fb72374ad005046</JobId>
      </DynamicImageJob>
</SubmitDynamicImageJobResponse>

JSON 形式 

{
    "RequestId": "25818875-5F78 ***** BEF6-D7393642CA58" 、
    "DynamicImageJob": {
        "JobId": "ad90a501b1b ***** fb72374ad005046"
    }
}

エラーコード

エラーコードリストについては、「API エラーセンター」をご参照ください。

共通エラー

次の表に、この操作で返される一般的なエラーを示します。

エラーコード

エラーメッセージ

HTTP ステータスコード

説明

InvalidVideo.NotFound

ビデオは存在しません。

404

ビデオが存在しない場合に返されるエラーメッセージ。

NoSuchResource

指定されたリソース % sは存在しません。

404

ユーザー関連のリソースが存在しない場合に返されるエラーメッセージ。 % sは、特定のリソース情報を示します。

Forbidden.IllegalStatus

ビデオのステータスは違法です。

400

ビデオのステータスが無効な場合に返されるエラーメッセージ。 ビデオの一部をキャプチャして動画を生成できるのは、ビデオの状態がUploadSucces、Transcoding、Normal、Checking、またはBlockedの場合のみです。