すべてのプロダクト
Search

このプロダクト

    Intelligent Media Management:CreateHighlightTask

    ドキュメントセンター

    Intelligent Media Management:CreateHighlightTask

    最終更新日:Jul 07, 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

    必須

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

    • 宠物

    • 人物

    • 运动

    • 会议

    値は 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

    任意

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

    レスポンスフィールド

    フィールド

    型

    説明

    例

    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-****"
}

    エラーコード

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

    変更履歴

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