すべてのプロダクト
Search

このプロダクト

    Intelligent Media Management:CreateHighlightTask

    ドキュメントセンター

    Intelligent Media Management:CreateHighlightTask

    最終更新日:Jun 22, 2026

    動画ハイライトタスクを作成します。この特徴は招待プレビュー中です。

    操作説明

    • この操作を使用する前に、Intelligent Media Management (IMM) の課金について十分に理解してください。 詳細については、課金概要を参照してください。この操作では、ハイライト抽出およびメディア処理の料金が発生します。このプロダクトの課金フォーマットの詳細については、上記リンクを参照してください。

    • この操作を呼び出す前に、現在のリージョンにプロジェクトが既に存在することを確認してください。詳細については、プロジェクト管理を参照してください。

      重要 非同期タスクは適時性スコアを保証しません。
      。

    今すぐお試しください

    この 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 ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    imm:CreateHighlightTask

    create

    *Project

    acs:imm:{#regionId}:{#accountId}:project/{#ProjectName}

    		 なし なし

    リクエスト構文

    POST  HTTP/1.1

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    ProjectName

    string

    必須

    プロジェクト名。

    immtest
    Sources

    array<object>

    必須

    プロセスするメディアリソースのリスト。 最大値は 10 個の動画です。

    object

    任意

    プロセスするメディアリソース。

    URI

    string

    必須

    メディアリソースの URI (OSS URI)。動画のみがサポートされています。

    oss://test-bucket/test-object
    StartTime

    number

    任意

    メディアリソースの開始時刻。有効な値: [0, 動画の持続時間]。 このパラメーターは、Type が Concat にセットされている場合にのみ効果があります。

    0
    Duration

    number

    任意

    メディアクリップの持続時間。単位: 秒。デフォルト値: 0 (動画の終わりを示します)。 このパラメーターは、Type が Concat にセットされている場合にのみ効果があります。

    0
    Mode

    string

    任意

    ハイライト認識モード。有効な値:

    • Scene: シーンおよびフレーム認識。

    • Average (デフォルト): 平均スライス認識。

    Average
    Type

    string

    必須

    プロセスタイプ。有効な値:

    • Retrieval: ハイライト抽出。

    • Concat: 動画混合ストリーム。

    • Compose: ワンクリック動画作成。

    Retrieval
    Highlight

    object

    任意

    ハイライト構成。

    Content

    string

    必須

    ハイライトコンテンツ。有効な値:

    • Pets

    • People

    • Sports

    • Meetings

    値は 100 文字を超えることはできません。

    character
    Edit

    object

    任意

    編集構成。

    Mode

    string

    必須

    編集モード。有効な値:

    • Sequential: シーケンシャルモード。

    Sequential
    BackgroundMusicMode

    string

    任意

    バックグラウンドミュージックモード。デフォルト値: Closed。有効な値:

    • Random: カスタムバックグラウンドミュージック、重みに基づいてランダムに選択。

    • Sequential: カスタムバックグラウンドミュージック、順序に従って適用。

    • Closed: バックグラウンドミュージックなし。

    Closed
    BackgroundMusics

    array<object>

    任意

    バックグラウンドミュージックトラック。このパラメーターは、BackgroundMusicMode が Random または Sequential にセットされている場合に効果があります。 最大値は 1 です。。

    object

    任意

    バックグラウンドミュージック。

    URI

    string

    必須

    バックグラウンドミュージックの URI (OSS URI)。音声ファイルのみがサポートされています。

    oss://test-bucket/test-object/test.mp3
    Volume

    number

    任意

    バックグラウンドミュージックのボリューム強度。有効な値: [0, 10]。デフォルト値: 0.2。値 1 は元のボリュームを示します。

    0.2
    TransitionMode

    string

    任意

    トランジションモード。デフォルト値: Closed。有効な値:

    • Auto: 自動トランジション。

    • Random: カスタムトランジション、重みに基づいてランダムに選択。

    • Sequential: カスタムトランジション、順序に従って適用。

    • Closed: トランジションなし。

    Closed
    Transitions

    array<object>

    任意

    トランジション効果。 このパラメーターは、TransitionMode が Random または Sequential にセットされている場合に有効です。 最大値は 10 個のトランジションです。

    object

    任意

    Transition

    string

    必須

    トランジション効果。詳細については、トランジション効果を参照してください。フォーマットの詳細については、開発者リファレンスを参照してください。

    fade
    Duration

    number

    任意

    トランジションの持続時間。単位: 秒。トランジションの持続時間がクリップの持続時間から 1 を引いた値より大きい場合、そのクリップのトランジション効果は有効になりません。 有効な値: [0, 5]。

    0
    Weight

    integer

    任意

    トランジションの重み。有効な値: [1, 100]。デフォルト値: 50。 このパラメーターは、TransitionMode が Random にセットされている場合に効果があります。

    50
    VfxEffectMode

    string

    任意

    効果モード。デフォルト値: Closed。有効な値:

    • Auto: 自動効果。

    • Random: カスタム効果、重みに基づいてランダムに選択。

    • Sequential: カスタム効果、順序に従って適用。

    • Closed: 効果なし。

    Closed
    VfxEffects

    array<object>

    任意

    ビジュアル効果。このパラメーターは、VfxEffectMode が Random または Sequential にセットされている場合に有効です。 最大値は 10 個の効果です。

    object

    任意

    VfxEffect

    string

    必須

    ビジュアル効果。詳細については、効果を参照してください。フォーマットの詳細については、開発者リファレンスを参照してください。

    letterboxed
    Weight

    integer

    任意

    効果の重み。有効な値: [1, 100]。デフォルト値: 50。 このパラメーターは、VfxEffectMode が Random に設定されている場合に有効です。

    50
    Output

    object

    必須

    出力構成。

    URI

    string

    必須

    出力ファイルの URI。

    oss://test-bucket/test-target-object.mp4
    Container

    string

    任意

    メディアコンテナタイプ。このパラメーターは、Type が Concat または Compose に設定されている場合に必須です。有効な値:

    • 音声および動画コンテナ: mp4、mkv、mov、asf、avi、mxf、ts、flv

    重要 Container と URI は一緒に指定する必要があります。
    。

    mp4
    Speed

    number

    任意

    メディアの再生速度。有効な値: [0.5, 1.0]。デフォルト値: 1.0。

    説明

    この値は、トランスコード中のメディアファイルのデフォルト再生速度とソースメディアファイルのデフォルト再生速度の比率です。これは速度調整トランスコードではありません。

    1.0
    Segment

    object

    任意

    メディアセグメント設定項目。デフォルトでは、セグメントは実行されません。

    Format

    string

    任意

    メディアセグメントフォーマット。有効な値:

    • hls

    • dash。

    hls
    Duration

    number

    任意

    セグメント期間。単位: 秒。

    1
    StartNumber

    integer

    任意

    開始番号。hls のみがサポートされています。デフォルト値: 0。

    0
    Video TargetVideo

    任意

    動画処理のパラメータ設定。

    重要 Video が空の場合、最初のビデオストリーム (存在する場合) が出力ファイルに直接コピーされます。

    Audio TargetAudio

    任意

    音声処理のパラメータ設定。

    重要 Audio が空の場合、最初の音声ストリーム (存在する場合) が出力ファイルに直接コピーされます。

    MaxDuration

    number

    任意

    クリッピングされた動画の最大値の持続時間。単位: 秒。

    10.0
    UserData

    string

    任意

    カスタムユーザーデータ。非同期メッセージ通知で返されます。

    {"ID": "testuid","Name": "test-user","Avatar": "http://test.com/testuid"}
    Tags

    object

    任意

    非同期タスクの検索およびフィルターに使用されるカスタムタグ。

    {"test":"val1"}
    CredentialConfig CredentialConfig

    任意

    権限付与構成。特定の要件がない限り、このパラメーターは空のままにしてください。。

    Notification Notification

    任意

    メッセージ通知構成。詳細については、Notification をクリックしてください。非同期通知メッセージのフォーマットについては、非同期通知メッセージフォーマットを参照してください。開発者リファレンスで詳細を確認できます。

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    レスポンスのスキーマ。

    RequestId

    string

    リクエスト ID。

    CA995EFD-083D-4F40-BE8A-BDF75FFFE0B6
    EventId

    string

    イベント ID。

    0ED-1Bz8z71k5TtsUejT4UJ16Es****
    TaskId

    string

    タスク ID。

    Highlight-4d51241b-04d4-4343-aa25-****

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "CA995EFD-083D-4F40-BE8A-BDF75FFFE0B6",
  "EventId": "0ED-1Bz8z71k5TtsUejT4UJ16Es****",
  "TaskId": "Highlight-4d51241b-04d4-4343-aa25-****"
}

    エラーコード

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

    変更履歴

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