すべてのプロダクト
Search

このプロダクト

    ApsaraVideo Media Processing:AddMedia

    ドキュメントセンター

    ApsaraVideo Media Processing:AddMedia

    最終更新日:Aug 28, 2026

    メディアを追加するタスクを送信します。

    操作説明

    • OSS に既存の動画が保存されている場合、この操作を使用して動画を OSS に再アップロードせずに処理できます。media workflow を設定している場合、メディアファイルが OSS にアップロードされると、OSS は自動的に ApsaraVideo Media Processing に通知します。設定された OSS バケットとオブジェクトに基づいて、システムはアクティブなワークフローを自動的にマッチングして実行します。したがって、ほとんどの場合、ファイルを処理するために AddMedia 操作を手動で呼び出す必要はありません。

    • メディア情報は、メディアファイルを処理するためにアクティブなワークフローを指定した場合にのみ自動的に取得されます。ワークフローを指定しないか、別のステータスのワークフローを指定した場合、メディア情報は取得されません。

    QPS 制限

    この操作の単一ユーザーあたりの QPS 制限は、毎秒 100 回の呼び出しです。制限を超えると、API 呼び出しがスロットリングされ、ビジネスに影響を与える可能性があります。この操作は適切に呼び出してください。詳細については、「QPS 制限」を参照してください。

    今すぐお試しください

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

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    mts:AddMedia

    create

    *すべてのリソース。

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    FileURL

    string

    必須

    入力ファイルのパス。ApsaraVideo Media Processing または OSS コンソールからパスを取得できます。トリガールールの詳細については、後述の「ワークフロートリガーのマッチングルールのルール」を参照してください。

    • OSS HTTP アドレスのみがサポートされています。CDN アドレスおよび HTTPS アドレスはサポートされていません。

    • 値は 3,200 バイトを超えることはできません。

    • URL は RFC 2396 に準拠する必要があります（UTF-8 エンコーディングおよび URL エンコード）。詳細については、「URL エンコード」を参照してください。

    http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/test.mp4
    Title

    string

    任意

    メディアのタイトル。

    • 値は 128 バイトを超えることはできません。

    • UTF-8 エンコード。

    mytest
    Description

    string

    任意

    説明。

    • 値は 1,024 バイトを超えることはできません。

    • UTF-8 エンコード。

    テスト動画
    CoverURL

    string

    任意

    カバー URL。設定するカバーのストレージの場所です。ApsaraVideo Media Processing コンソール > ワークフロー管理 > メディアバケット、または OSS コンソール > マイアクセスパスからアドレスを取得できます。

    • 値は 3,200 バイトを超えることはできません。

    • URL は RFC 2396 に準拠する必要があります（UTF-8 エンコーディングおよび URL エンコード）。詳細については、「URL エンコード」を参照してください。

    http://bucket.oss-cn-hangzhou.aliyuncs.com/example/1.png
    Tags

    string

    任意

    タグのリスト。

    説明

    ApsaraVideo Media Processing では、各メディアの各タグは独立しています。メディア ライブラリを検索して、同じタグを持つすべてのメディアを見つけることができます。

    • 複数のタグはカンマ (,) で区切ります。最大値は 16 個のタグです。

    • 各タグは 32 バイトを超えることはできません。

    • UTF-8 エンコード。

    tag1,tag2
    MediaWorkflowId

    string

    任意

    media workflow の ID。ApsaraVideo Media Processing コンソール、または AddMediaWorkflow 操作を呼び出して ID を取得できます。

    説明

    • このパラメータータスクは非同期タスクです。送信後、タスクはすぐには完了せず、バックグラウンドでの非同期実行のためにキューに入れられます。

    07da6c65da7f458997336e0de192****
    MediaWorkflowUserData

    string

    任意

    media workflow のカスタムデータ。

    • 値は 1,024 バイトを超えることはできません。

    • UTF-8 エンコード。

    test
    InputUnbind

    boolean

    任意

    指定されたワークフローが入力パスをサポートしているかどうかを確認するかどうかを指定します。誤ったパスによるエラーを回避するには、このパラメーターを true に設定します。有効な値:

    • true: 確認します。

    • false: 確認しません。

    false
    CateId

    integer

    任意

    メディアのカテゴリ ID。負の値は使用できません。

    123
    OverrideParams

    string

    任意

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

    • 例 1: HLS パッケージング字幕のオーバーライド {"WebVTTSubtitleOverrides",[{"RefActivityName":"subtitleNode","WebVTTSubtitleURL":"http://test.oss-cn-hangzhou.aliyuncs.com/example1.vtt"}]}。

    • 例 2: DASH パッケージング字幕のオーバーライド {"subtitleTransNodeName":{"InputConfig":{"Format":"stl","InputFile":{"URL":"http://subtitleBucket.oss-cn-hangzhou.aliyuncs.com/package/example/CENG.stl"}}}}。

    {“subtitleTransNodeName”:{“InputConfig”:{“Format”:”stl”,”InputFile”:{“URL”:”http://exampleBucket.oss-cn-hangzhou.aliyuncs.com/package/example/CENG.stl”}}}}

    ワークフロートリガーのマッチングルールのルール

    ルールマッチング実行ポリシーは次のとおりです。新しいファイルのパスに基づいて、システムはワークフローにバインドされた場所を確認します。新しいファイルのパスにルールにバインドされた文字列が含まれている場合、ルールはマッチします。それ以外の場合、ルールはマッチしません。たとえば、http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/test1.flv の場合、ルールは次のようになります。

    1、http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/          マッチ
2、http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/            マッチ
3、http://bucket.oss-cn-hangzhou.aliyuncs.com/A/              マッチ
4、http://bucket.oss-cn-hangzhou.aliyuncs.com/                マッチ
5、http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/test.flv  マッチ
6、http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/CC/         マッチしない
7、http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B2/           マッチしない
8、http://bucket.oss-cn-hangzhou.aliyuncs.com/A2/B/C/         マッチしない
    説明

    media workflow を追加する際、あるワークフローの入力パスを別のワークフローの入力パスのプレフィックスとして設定しないでください。そうしないと、単一の増分ファイルが 2 つのワークフロー実行インスタンスをトリガーしてしまいます。たとえば、2 つのワークフローの入力パスが test および test1 と設定されている場合、入力ファイルが test1 フォルダーにアップロードされると、test プレフィックスにもマッチし、2 つのワークフロー実行インスタンスがトリガーされます。

    ファイル名拡張子のマッチング

    トリガーにはマルチメディアファイルが必要です。メディア ライブラリはファイル名拡張子によってファイルタイプを判別します。ファイルにはファイル名拡張子がないか（ファイル名に拡張子区切り文字 "." が含まれていない）、または以下のルールに準拠したファイル名拡張子が必要です。

    説明

    SWF ファイルの場合、スナップショットおよびトランスコーディングサービスの品質は保証されません。

    タイプ拡張子
    動画3gp, asf, avi, dat, dv, flv, f4v, gif, m2t, m3u8, m4v, mj2, mjpeg, mkv, mov, mp4, mpe, mpg, mpeg, mts, ogg, qt, rm, rmvb, swf, ts, vob, wmv, webm
    音声aac, ac3, acm, amr, ape, caf, flac, m4a, mp3, ra, wav, wma, aiff

    media workflow メッセージ

    media workflow は、Alibaba Cloud Simple Message Queue（旧 MNS）を使用して、ビデオクラウドサービスのコンシューマーにメッセージを送信します。media workflow は、Start または Report アクティビティノードが完了したときにメッセージを送信します。メッセージを受信するには、Start アクティビティでキューまたは通知名をセットします。media workflow によって生成されたメッセージは、キューまたは通知に保存されます。Simple Message Queue（旧 MNS）SDK を使用してメッセージを取得できます。メッセージの仕様は次のとおりです。

    名前タイプ説明
    RunIdStringワークフロー実行 ID。
    NameStringアクティビティ名。
    TypeStringアクティビティタイプ。有効な値: Report、Start。
    StateStringアクティビティステータス。有効な値: Fail、Success。
    CodeStringエラーコード。アクティビティステータスが Fail の場合、特定のエラーコードが返されます。
    MessageStringエラーメッセージ。アクティビティステータスが Fail の場合、詳細なエラーの説明が返されます。
    MediaWorkflowExecutionMediaWorkflowExecutionmedia workflow の実行情報。

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    応答パラメーター。

    RequestId

    string

    リクエスト ID。

    05F8B913-E9F3-4A6F-9922-48CADA0FFAAD
    Media

    object

    メディア情報。

    CreationTime

    string

    作成時間。

    2016-09-20T03:02:40Z
    CateId

    integer

    カテゴリ ID。

    1
    Height

    string

    メディアファイルの高さ。

    1280
    CensorState

    string

    動画のモデレーションステータス。有効な値:

    • Initiated: 開始済み。動画はアップロードされていますが、モデレーションは完了していません。

    • Pass: 合格。動画はアップロードされており、モデレーションに合格しています。

    Initiated
    Tags

    object

    Tag

    array

    タグ。

    string

    タグのリスト。

    tag,tag2
    Bitrate

    string

    ビットレート。

    1148.77
    MediaId

    string

    メディア ID。

    3e6149d5a8c944c09b1a8d2dc3e4****
    File

    object

    元のファイル。

    State

    string

    ファイルのステータス。デフォルト値は 法線 です。

    Normal
    URL

    string

    ファイル URL。

    http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/test.mp4
    PublishState

    string

    メディアの公開ステータス。メディアが外部に公開されているかどうかを示します。有効な値:

    • Initiated: 開始済み。

    • UnPublish: 非公開。OSS 再生ファイルの権限は Private です。

    • Published: 公開。OSS 再生ファイルの権限は Default です。

    Published
    Description

    string

    説明。値は 1,024 バイトを超えることはできません。

    テスト動画
    Width

    string

    メディアファイルの幅。

    1280
    Size

    string

    メディアファイルのサイズ。

    379860
    CoverURL

    string

    カバー URL。

    http://bucket.oss-cn-hangzhou.aliyuncs.com/example/1.png
    RunIdList

    object

    RunId

    array

    media workflow 実行インスタンス ID のリスト。

    string

    実行された media workflow 実行インスタンス ID のリスト。カンマ (,) で区切られます。

    {"RunId":["cbad98d35629470fa05ff393d347****"]}
    Duration

    string

    メディアファイルの持続時間。

    2.645333
    Fps

    string

    メディアファイルのフレームレート。

    25.0
    Title

    string

    メディアのタイトル。値は 128 バイトを超えることはできません。

    mytest.mp4
    Format

    string

    フォーマット。サポートされているフォーマット: mov、mp4、m4a、3gp、3g2、mj2。

    mp4

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "05F8B913-E9F3-4A6F-9922-48CADA0FFAAD",
  "Media": {
    "CreationTime": "2016-09-20T03:02:40Z",
    "CateId": 1,
    "Height": "1280",
    "CensorState": "Initiated",
    "Tags": {
      "Tag": [
        "tag,tag2"
      ]
    },
    "Bitrate": "1148.77",
    "MediaId": "3e6149d5a8c944c09b1a8d2dc3e4****",
    "File": {
      "State": "Normal",
      "URL": "http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/test.mp4"
    },
    "PublishState": "Published",
    "Description": "A test video",
    "Width": "1280",
    "Size": "379860",
    "CoverURL": "http://bucket.oss-cn-hangzhou.aliyuncs.com/example/1.png",
    "RunIdList": {
      "RunId": [
        "{\"RunId\":[\"cbad98d35629470fa05ff393d347****\"]}"
      ]
    },
    "Duration": "2.645333",
    "Fps": "25.0",
    "Title": "mytest.mp4",
    "Format": "mp4"
  }
}

    エラーコード

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

    変更履歴

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