すべてのプロダクト
Search

このプロダクト

    Intelligent Media Services:SubmitLiveEditingJob

    ドキュメントセンター

    Intelligent Media Services:SubmitLiveEditingJob

    最終更新日:Apr 07, 2026

    ライブ編集は、ライブストリームから 1 つ以上のセグメントを結合して出力ファイルを生成します。ライブ編集ジョブを送信すると、非同期で処理されます。その後、返された JobId を用いて GetLiveEditingJob 操作を呼び出し、ジョブのステータスをクエリできます。また、MediaId を用いて GetMediaInfo 操作を呼び出し、生成されたメディアアセットの詳細を取得することも可能です。

    操作説明

    • これは 非同期 API です。ジョブを送信すると、ジョブが完了する前にシステムから JobId が返されます。その後、ジョブは非同期処理のためにキューに入れられます。ジョブが完了すると、コールバック通知 を受信します。または、GetLiveEditingJob 操作を呼び出してジョブステータスをクエリすることもできます。

    • OSS または VOD のいずれかに録画されたライブストリームを編集できます。複数のライブストリームをまとめて編集する場合、すべてのストリームは同じサービス (すべて OSS またはすべて VOD) に録画されている必要があります。

    今すぐお試しください

    この 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:SubmitLiveEditingJob

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    Clips

    string

    必須

    編集するクリップを指定する JSON 配列です。ジョブは、指定された順序でこれらのクリップを連結して出力ファイルを生成します。

    各クリップには開始時刻と終了時刻が含まれます。クリップにライブストリームパラメーターが指定されていない場合、システムはグローバルの LiveStreamConfig 設定を使用します。開始と終了のタイムスタンプは協定世界時 (UTC) である必要があります。詳細については、後述の Clip データ構造をご参照ください。

    [{\"StartTime\": \" 2021-06-21T08:01:00Z\", \"EndTime\": \" 2021-06-21T08:03:00Z\" , "AppName": "app", "DomainName": "domain.com", "StreamName": "stream"}, {\"StartTime\": \" 2021-06-21T08:05:00Z\", \"EndTime\": \" 2021-06-21T08:09:00Z\" }]
    ProjectId

    string

    任意

    ライブ編集プロジェクトの ID です。このパラメーターを指定すると、システムはプロジェクトのストレージ設定を使用します。このパラメーターを空にした場合、システムはリクエストで指定されたストレージ設定を使用します。

    ****fddd7748b58bf1d47e95****
    LiveStreamConfig

    string

    任意

    ソースライブストリームの構成を JSON オブジェクトとして指定します。次のパラメーターが含まれます：

    • AppName： ストリームが属するアプリケーションの名前。

    • DomainName： ストリームのドメイン名。

    • StreamName： ライブストリームの名前。

    { "AppName": "app", "DomainName": "domain.com", "StreamName": "stream" }
    OutputMediaConfig

    string

    任意

    出力ファイルの送信先設定を JSON オブジェクトとして指定します。OSS 上の URL または VOD バケット内のストレージ場所のいずれかを指定できます。

    • OSS に出力するには、MediaURL パラメーターが必要です。

    • VOD に出力するには、StorageLocation と FileName パラメーターが必要です。

    { "MediaURL": "https://ice-auto-test.oss-cn-shanghai.aliyuncs.com/testfile.mp4" }, 或 { "StorageLocation": "bucket.oss-cn-shanghai.aliyuncs.com", "FileName": "output.mp4" }
    MediaProduceConfig

    string

    任意

    出力ファイルの生成設定を JSON オブジェクトとして指定します。Mode パラメーターは編集モードを指定します。有効な値は次のとおりです：

    • AccurateFast (デフォルト)： 高速かつ正確な編集。Accurate モードと比較して高速な処理を提供します。出力ファイルの解像度はソースストリームと同じです。出力ファイルの幅と高さをカスタムで指定することはできません。

    • Accurate： 正確な編集。このモードでは、出力ファイルの幅と高さをカスタムで指定できます。

    • Rough： 単一の TS セグメントの精度でのラフ編集。出力ファイルには、指定された開始時刻と終了時刻の間のすべてのセグメントが含まれます。出力ファイルの幅と高さをカスタムで指定できます。

    • RoughFast： 高速なラフカット編集で、Accurate モードよりも高速です。単一の TS セグメントの精度を持ち、出力ファイルには指定された開始時刻と終了時刻の間のすべてのセグメントが含まれます。出力ファイルの解像度はソースストリームと同じです。出力ファイルの幅と高さをカスタムで指定することはできません。

    { "Mode": "AccurateFast"}
    UserData

    string

    任意

    カスタムユーザーデータを JSON オブジェクトとして指定します。最大長は 512 バイトです。

    {"key": "value"}
    OutputMediaTarget

    string

    任意

    出力ファイルの送信先タイプです。有効な値：

    • oss-object： Alibaba Cloud OSS バケット内のオブジェクト。

    • vod-media： Alibaba Cloud VOD のメディアアセット。

    oss-object

    Clip データ構造

    パラメータータイプ例説明必須
    StartTimeString2021-06-21T08:01:00Zクリップの開始時刻 (UTC フォーマット)。はい
    EndTimeString2021-06-21T08:05:00Zクリップの終了時刻 (UTC フォーマット)。はい
    AppNameStringappストリームが属するアプリケーションの名前。指定しない場合、システムはグローバルの LiveStreamConfig 設定を使用します。いいえ
    DomainNameStringdomain.comストリームのドメイン名。指定しない場合、システムはグローバルの LiveStreamConfig 設定を使用します。いいえ
    StreamNameStringstreamライブストリームの名前。指定しない場合、システムはグローバルの LiveStreamConfig 設定を使用します。いいえ
    CoverTimeString2021-06-21T08:03:00Z出力ファイルのカバー画像を生成するために使用するクリップ内のタイムスタンプを指定します。時刻は UTC フォーマットである必要があります。複数のクリップに CoverTime が設定されている場合、システムは最初のもののみを使用します。CoverTime は StartTime 以上かつ EndTime 以下である必要があります。いいえ
    CoverUrlStringhttps://test.oss-cn-shanghai.aliyuncs.com/cover.jpg出力スクリーンショットのカスタム URL。OSS バケットは、サービスと同じリージョンに存在する必要があります。自己管理 OSS バケットのみがサポートされており、VOD 管理バケットはサポートされていません。いいえ

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    応答オブジェクト。

    RequestId

    string

    リクエストの ID。

    ****36-3C1E-4417-BDB2-1E034F****
    ProjectId

    string

    ライブ編集プロジェクトの ID。

    ****fddd7748b58bf1d47e95****
    JobId

    string

    ライブ編集ジョブの ID。

    ****d80e4e4044975745c14b****
    MediaId

    string

    出力メディアアセットの ID。

    ****c469e944b5a856828dc2****
    MediaURL

    string

    出力ファイルの URL。

    http://test-bucket.cn-shanghai.aliyuncs.com/test.mp4
    VodMediaId

    string

    VOD メディアアセットの ID。このパラメーターは、出力先が VOD の場合にのみ返されます。

    ****d7578s4h75ci945c14b****

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "****36-3C1E-4417-BDB2-1E034F****",
  "ProjectId": "****fddd7748b58bf1d47e95****",
  "JobId": "****d80e4e4044975745c14b****",
  "MediaId": "****c469e944b5a856828dc2****",
  "MediaURL": "http://test-bucket.cn-shanghai.aliyuncs.com/test.mp4",
  "VodMediaId": "****d7578s4h75ci945c14b****"
}

    エラーコード

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

    変更履歴

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