すべてのプロダクト
Search

このプロダクト

    Intelligent Media Services:SubmitDynamicImageJob

    ドキュメントセンター

    Intelligent Media Services:SubmitDynamicImageJob

    最終更新日:Sep 11, 2026

    アニメーションイメージを生成するタスクを送信します。

    操作説明

    これは非同期操作です。タスクを送信すると、タスク 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

    *すべてのリソース。

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    Name

    string

    任意

    タスク名。

    SampleJob
    Input

    object

    必須

    タスクの入力。

    Media

    string

    必須

    入力メディア。

    • Type が OSS に設定されている場合は、OSS URL を指定します。

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

    OSS URL のフォーマット:

    1. oss://bucket/object

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

    URL 内の bucket は、現在のプロジェクトと同じリージョンに存在する OSS バケットの名前であり、オブジェクトはファイルパスです。

    説明

    URL 内の OSS バケットを使用する前に、それを IMS のストレージ管理に追加してください。

    oss://bucket/object.mp4
    Type

    string

    必須

    入力タイプ。有効な値:

    • OSS: OSS ファイル URL。

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

    列挙値:

    • Media :

      メディアアセット ID。

    • OSS :

      OSS URL。

    OSS
    Output

    object

    必須

    タスクの出力。

    Media

    string

    必須

    出力メディア。OSS URL とメディアアセット ID の両方がサポートされています。 OSS URL のフォーマット:

    • oss://bucket/object

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

    URL 内の bucket は、現在のプロジェクトと同じリージョンに存在する OSS バケットの名前であり、オブジェクトはファイルパスです。

    説明

    URL 内の OSS バケットを使用する前に、それを IMS のストレージ管理に追加してください。

    ****96e8864746a0b6f3****
    Type

    string

    必須

    出力タイプ。有効な値:

    • OSS: OSS ファイル URL。

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

    列挙値:

    • Media :

      メディアアセット ID。

    • OSS :

      OSS URL。

    Media
    TemplateConfig

    object

    必須

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

    OverwriteParams

    object

    任意

    オーバーライドパラメーター。

    Format

    string

    任意

    アニメーションイメージのフォーマット。有効な値:

    • gif

    • webp

    列挙値:

    • gif :

      gif。

    • webp :

      webp。

    gif
    Fps

    integer

    任意

    フレームレート。有効な値: 1～60。

    15
    Height

    integer

    任意

    出力アニメーションイメージの高さ。有効な値: 128～4096。

    720
    LongShortMode

    boolean

    任意

    自動回転 (長短辺モード) を有効にするかどうかを指定します。有効な値:

    • true: 自動回転を有効にします。

    • false: 自動回転を無効にします。

    デフォルト値: true。

    説明

    トランスコード中の出力の幅は入力ソースの長辺 (縦動画の場合は高さ) に対応し、高さは入力ソースの短辺 (縦動画の場合は幅) に対応します。

    列挙値:

    • true :

      true。

    • false :

      false。

    false
    ScanMode

    string

    任意

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

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

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

    列挙値:

    • progressive :

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

    • interlaced :

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

    progressive
    TimeSpan

    object

    任意

    タイムラインパラメーター。

    Duration

    string

    任意

    持続時間。

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

    • 有効な値: [00:00:00.000,23:59:59.999] または [0.000,86399.999]。

    01:59:59.999 or 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 or 32000.23
    Seek

    string

    任意

    開始時刻。

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

    • 有効な値: [00:00:00.000,23:59:59.999] または [0.000,86399.999]。

    01:59:59.999 or 32000.23
    Width

    integer

    任意

    出力アニメーションイメージの幅。有効な値: 128～4096。

    1024
    TemplateId

    string

    必須

    テンプレートの ID。

    ****96e8864746a0b6f3****

    ScheduleConfig

    object

    任意

    スケジューリング構成。

    PipelineId

    string

    任意

    パイプラインの ID。

    ****96e8864746a0b6f3****

    Priority

    integer

    任意

    優先度。有効な値: 1～10。デフォルト値: 6。値が大きいほど優先度が高くなります。

    6
    UserData

    string

    任意

    カスタムユーザーデータ。

    {"SampleKey": "SampleValue"}

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    PlainResponse

    JobId

    string

    タスクの ID。

    ****20b48fb04483915d4f2cd8ac****
    RequestId

    string

    リクエストの ID。

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

    例

    成功レスポンス

    JSONJSON

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

    エラーコード

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

    変更履歴

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