すべてのプロダクト
Search

このプロダクト

    Intelligent Media Services:SubmitDynamicImageJob

    ドキュメントセンター

    Intelligent Media Services:SubmitDynamicImageJob

    最終更新日:Apr 07, 2026

    この API を使用して、動的イメージを生成するタスクを送信します。

    操作説明

    これは非同期インターフェイスです。タスクを送信すると、タスクはバックグラウンドで非同期実行のためにキューに入れられ、すぐにタスク ID が返されます。最終結果はコールバック通知で送信されるか、動的イメージタスクの詳細をクエリすることでタスクステータスをポーリングできます。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    ice:SubmitDynamicImageJob

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    Name

    string

    任意

    ジョブ名。

    SampleJob
    Input

    object

    必須

    ジョブ入力。

    Type

    string

    必須

    ジョブ入力のタイプ。有効な値：

    • OSS：Object Storage Service (OSS) ファイルの URL。

    • Media：メディアアセット ID。

    列挙値:

    • Media :

      メディアアセット ID。

    • OSS :

      OSS URL。

    OSS
    Media

    string

    必須

    入力メディアリソース。

    • Type が OSS に設定されている場合、入力ファイルの OSS URL を指定します。

    • Type が Media に設定されている場合、メディアアセット ID を指定します。

    OSS URL は、次のいずれかのフォーマットである必要があります：

    1. oss://bucket/object

    2. http(s)://bucket.oss-[RegionId].aliyuncs.com/object

    これらのフォーマットでは、bucket は現在のプロジェクトと同じリージョンにある OSS バケットの名前で、object はファイルパスです。

    説明

    指定された OSS バケットは、IMS のストレージ管理に登録されている必要があります。

    oss://bucket/object.mp4
    Output

    object

    必須

    ジョブ出力。

    Type

    string

    必須

    ジョブ出力のタイプ。有効な値：

    • OSS：出力は OSS ファイルです。

    • Media：出力は新しいメディアアセットです。

    列挙値:

    • Media :

      新しいメディアアセットが作成されます。

    • OSS :

      OSS ファイル。

    Media
    Media

    string

    必須

    出力ファイルの送信先 OSS URL。このパラメーターは、Type が OSS に設定されている場合に必須です。URL は、次のいずれかのフォーマットである必要があります：

    • oss://bucket/object

    • http(s)://bucket.oss-[regionId].aliyuncs.com/object

    これらのフォーマットでは、bucket は現在のプロジェクトと同じリージョンにある OSS バケットの名前で、object はファイルパスです。

    説明

    指定された OSS バケットは、IMS のストレージ管理に登録されている必要があります。

    ****96e8864746a0b6f3****
    TemplateConfig

    object

    必須

    スナップショットテンプレートの構成。

    TemplateId

    string

    必須

    テンプレート ID。

    ****96e8864746a0b6f3****

    OverwriteParams

    object

    任意

    上書きパラメーター。

    Format

    string

    任意

    動的イメージのフォーマット。有効な値：

    • gif

    • webp

    列挙値:

    • gif :

      gif

    • webp :

      webp

    gif
    Width

    integer

    任意

    出力される動的イメージの幅。有効範囲：[128, 4096]。

    1024
    Height

    integer

    任意

    出力される動的イメージの高さ。有効範囲：[128, 4096]。

    720
    Fps

    integer

    任意

    フレームレート。有効範囲：[1, 60]。

    15
    ScanMode

    string

    任意

    スキャンモード。有効な値：

    • interlaced：インターレーススキャン。

    • progressive：プログレッシブスキャン。これがデフォルト値です。

    列挙値:

    • progressive :

      プログレッシブスキャン。

    • interlaced :

      インターレーススキャン。

    progressive
    LongShortMode

    boolean

    任意

    動画の長辺と短辺に基づいて、向きを自動調整するかどうかを指定します。有効な値：

    • true：自動調整を有効にします。

    • false：自動調整を無効にします。

    デフォルト値：true。

    説明

    有効にすると、このモードは出力幅をソース動画の長辺に、出力高さを短辺に設定します。縦向き動画の場合、高さが長辺、幅が短辺として扱われます。

    列挙値:

    • true :

      true

    • false :

      false

    false
    TimeSpan

    object

    任意

    動的イメージを生成するために処理する動画の時間範囲を指定します。

    Seek

    string

    任意

    処理する動画セグメントの開始時刻。

    • フォーマット：hh:mm:ss[.SSS] または sssss[.SSS]。

    • 有効範囲：[00:00:00.000,23:59:59.999] または [0.000,86399.999]。

    01:59:59.999 或 32000.23
    Duration

    string

    任意

    処理する動画セグメントの持続時間。

    • フォーマット：hh:mm:ss[.SSS] または sssss[.SSS]。

    • 有効範囲：[00:00:00.000,23:59:59.999] または [0.000,86399.999]。

    01:59:59.999 或 32000.23
    End

    string

    任意

    処理する動画セグメントの終了時刻。このパラメーターが設定されている場合、Duration パラメーターは無視されます。

    • フォーマット：hh:mm:ss[.SSS] または sssss[.SSS]。

    • 有効範囲：[00:00:00.000,23:59:59.999] または [0.000,86399.999]。

    01:59:59.999 或 32000.23
    ScheduleConfig

    object

    任意

    スケジューリング構成。

    PipelineId

    string

    任意

    パイプライン ID。

    ****96e8864746a0b6f3****

    Priority

    integer

    任意

    ジョブの優先度。有効範囲：[1, 10]。値が大きいほど優先度が高くなります。デフォルト値：6。

    6
    UserData

    string

    任意

    ユーザー定義データ。

    {"SampleKey": "SampleValue"}

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    PlainResponse

    RequestId

    string

    リクエスト ID。

    ******11-DB8D-4A9A-875B-275798******
    JobId

    string

    ジョブ ID。

    ****20b48fb04483915d4f2cd8ac****

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "JobId": "****20b48fb04483915d4f2cd8ac****"
}

    エラーコード

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。