すべてのプロダクト
Search

このプロダクト

    :GetMezzanineInfo

    ドキュメントセンター

    :GetMezzanineInfo

    最終更新日:Dec 09, 2025

    オーディオまたはビデオファイルのソースファイル情報 (ファイル URL、解像度、ビットレートなど) を取得します。

    操作説明

    ソースファイルの完全な情報は、ビデオまたはオーディオストリームがトランスコードされた後に利用可能になります。

    今すぐお試しください

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

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    vod:GetMezzanineInfo

    get

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    VideoId

    string

    任意

    オーディオまたはビデオファイルの ID。次のいずれかの方法で ID を取得します：

    • コンソールにアップロードされたオーディオまたはビデオファイルの場合：VOD コンソールにログインします。ナビゲーションウィンドウで、[メディアライブラリ] > [オーディオ/ビデオ] を選択して、ビデオ ID を表示します。

    • CreateUploadVideo 操作を呼び出してアップロード URL と認証情報を取得すると、オーディオ/ビデオ ID は応答の `VideoId` パラメーターの値になります。

    • ビデオがアップロードされた後、SearchMedia 操作を呼び出してオーディオ/ビデオ ID をクエリします。ID は応答の `VideoId` パラメーターの値です。

    1f1a6fc03ca04814031b8a6559e****
    AuthTimeout

    integer

    任意

    ソースファイル (`FileURL`) の署名付き URL の有効期限。単位：秒。デフォルト値は 3600 です。最小値は 1 です。

    • `OutputType` が cdn に設定されている場合：

      • URL 署名が有効になっている場合にのみ `FileURL` は有効期限が切れます。それ以外の場合、URL は永続的に有効です。

      • 最小値：1。

      • 最大値：無制限。

      • デフォルト値：3600。

    • `OutputType` が oss に設定されている場合：

      • ストレージ権限が非公開に設定されている場合にのみ `FileURL` は有効期限が切れます。それ以外の場合、URL は永続的に有効です。

      • 最大値：オリジンでのセキュリティリスクを軽減するため、オーディオまたはビデオファイルが VOD バケットに保存されている場合、最大値は 2592000 (30 日) です。オーディオまたはビデオファイルがお客様自身の OSS バケットに保存されている場合、最大値は 129600 (36 時間) です。

      • デフォルト値：3600。

      • デフォルト値：3600。

    3600
    OutputType

    string

    任意

    出力 URL のタイプ。有効な値：

    • oss：オリジン URL。

    • cdn (デフォルト)：アクセラレーション URL。

    説明

    ソースファイルのバケットタイプが `in` の場合、OSS URL のみが返されます。

    oss
    AdditionType

    string

    任意

    追加情報のタイプ。複数のタイプはコンマ (,) で区切ります。デフォルトでは、基本情報のみが返されます。有効な値：

    • video：ビデオストリーム情報。

    • audio：オーディオストリーム情報。

    video
    ReferenceId

    string

    任意

    カスタム ID。ID には、小文字、大文字、数字、ハイフン (-)、アンダースコア (_) のみを含めることができます。ID は 6～64 文字の長さで、各ユーザーに対して一意である必要があります。

    123-123

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    返される応答。

    RequestId

    string

    リクエストの ID。

    25818875-5F78-4AF6-D7393642CA58****
    Mezzanine

    object

    ファイル情報。

    CreationTime

    string

    ファイルが作成された時刻。時刻は yyyy-MM-ddTHH:mm:ssZ 形式の UTC です。

    2017-11-14T09:15:50Z
    Status

    string

    ファイルのステータス。有効な値：

    • Uploading：ファイルの初期状態。ファイルがアップロード中であることを示します。

    • Normal：ファイルはアップロード済みです。

    • UploadFail：ファイルのアップロードに失敗しました。

    • Deleted：ファイルは削除済みです。

    Normal
    FileURL

    string

    ソースファイルの URL。

    http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/27ffc438-164h67f57ef-0005-6884-51a-1****.mp4
    VideoId

    string

    ビデオの ID。

    1f1a6fc03ca04814031b8a6559e****
    Height

    integer

    ファイルの高さ。単位：ピクセル。

    540
    Bitrate

    string

    ファイルのビットレート。単位：Kbps。

    771.2280
    FileName

    string

    ファイルの名前。

    27ffc438-164h67f57ef-0005-6884-51a-1****.mp4
    OutputType

    string

    出力 URL のタイプ。有効な値：

    • oss：オリジン URL。

    • cdn (デフォルト)：アクセラレーション URL。

    説明

    MP4 形式のファイルの OSS URL のみ再生がサポートされています。

    oss
    PreprocessStatus

    string

    前処理ステータス。有効な値：

    • UnPreprocess：前処理は実行されません。

    • Preprocessing：ファイルは前処理中です。

    • PreprocessSucceed：ファイルは前処理済みです。

    • PreprocessFailed：ファイルの前処理に失敗しました。

    UnPreprocess
    Width

    integer

    ファイルの幅。単位：ピクセル。

    960
    Size

    integer

    ファイルのサイズ。単位：バイト。

    4096477
    Duration

    string

    ファイルのデュレーション。単位：秒。

    42.4930
    Fps

    string

    ファイルのフレームレート (fps)。

    25.0000
    AudioStreamList

    array<object>

    オーディオストリームに関する情報。

    object

    オーディオストリームの詳細。

    Index

    string

    オーディオストリームの序数。メディアストリーム全体におけるオーディオストリームの位置を示します。

    0
    Timebase

    string

    タイムベース。

    0.000000
    SampleFmt

    string

    サンプリングフォーマット。

    fltp
    SampleRate

    string

    サンプルレート。

    44100
    ChannelLayout

    string

    サウンドチャンネルのレイアウト。有効な値：

    • mono：モノラル。

    • stereo：ステレオ。

    mono
    Lang

    string

    言語。

    und
    CodecLongName

    string

    エンコード形式の正式名称。

    AAC (Advanced Audio Coding)
    Channels

    string

    サウンドチャンネルの数。

    1
    NumFrames

    string

    総フレーム数。

    1
    Bitrate

    string

    ビットレート。

    62.885
    CodecTagString

    string

    エンコード形式のタグ。

    mp4a
    StartTime

    string

    開始時刻。時刻は yyyy-MM-ddTHH:mm:ssZ 形式の UTC です。

    2017-01-11T12:00:00Z
    CodecName

    string

    エンコード形式の短縮名。

    aac
    Duration

    string

    デュレーション。

    3.227574
    CodecTag

    string

    エンコード形式のタグ。

    0x6134706d
    CodecTimeBase

    string

    コーデックタイムベース。

    1/44100
    VideoStreamList

    array<object>

    ビデオストリームに関する情報。

    object

    ビデオストリームの詳細。

    Timebase

    string

    タイムベース。

    0.000000
    Index

    string

    ビデオストリームの序数。メディアストリーム全体におけるビデオストリームの位置を示します。

    1
    AvgFPS

    string

    平均フレームレート。

    30.0
    PixFmt

    string

    ピクセルフォーマット。

    yuv420p
    Lang

    string

    言語。

    und
    Sar

    string

    サンプルアスペクト比 (SAR)。

    0:1
    Height

    string

    ビデオの高さ。

    320
    CodecLongName

    string

    エンコード形式の正式名称。

    H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
    NumFrames

    string

    総フレーム数。

    0
    Bitrate

    string

    ファイルのビットレート。単位：Kbps。

    500
    Rotate

    string

    ビデオの回転角度。有効な値：[0, 360)。

    90
    CodecTagString

    string

    エンコード形式のタグ。

    avc1
    HasBFrames

    string

    B フレームが存在するかどうかを示します。

    0
    Profile

    string

    コーデックプロファイル。

    Main
    StartTime

    string

    開始時刻。時刻は yyyy-MM-ddTHH:mm:ssZ 形式の UTC です。

    2017-01-11T12:00:00Z
    Dar

    string

    表示アスペクト比 (DAR)。

    0:1
    CodecName

    string

    エンコード形式の短縮名。

    h264
    Width

    string

    ビデオの幅。

    568
    Duration

    string

    デュレーション。

    3.166667
    Fps

    string

    宛先フレームレート。

    30.0
    CodecTag

    string

    エンコード形式のタグ。

    0x31637661
    CodecTimeBase

    string

    コーデックタイムベース。

    1/60
    Level

    string

    エンコードレベル。

    30
    HDRType

    string

    ビデオストリームのハイダイナミックレンジ (HDR) タイプ。

    HDR
    StorageClass

    string

    メディアアセットのストレージクラス。有効な値：

    • Standard：標準。

    • IA：低頻度アクセス。

    • Archive：アーカイブ。

    • ColdArchive：コールドアーカイブ。

    • SourceIA：ソース低頻度アクセス。

    • SourceArchive：ソースアーカイブ。

    • SourceColdArchive：ソースコールドアーカイブ。

    • Changing：メディアアセットのストレージクラスは変更中です。

    • SourceChanging：ソースファイルのストレージクラスは変更中です。

    Standard
    RestoreStatus

    string

    メディアアセットの解凍状態。有効な値：

    • Processing：メディアアセットは解凍中です。

    • Success：メディアアセットは解凍済みです。

    • Failed：メディアアセットの解凍に失敗しました。

    Success
    RestoreExpiration

    string

    解凍されたメディアアセットの有効期限。

    2023-03-30T10:14:14Z
    FileMD5

    string

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "25818875-5F78-4AF6-D7393642CA58****",
  "Mezzanine": {
    "CreationTime": "2017-11-14T09:15:50Z",
    "Status": "Normal",
    "FileURL": "http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/27ffc438-164h67f57ef-0005-6884-51a-1****.mp4",
    "VideoId": "1f1a6fc03ca04814031b8a6559e****",
    "Height": 540,
    "Bitrate": "771.2280",
    "FileName": "27ffc438-164h67f57ef-0005-6884-51a-1****.mp4",
    "OutputType": "oss",
    "PreprocessStatus": "UnPreprocess",
    "Width": 960,
    "Size": 4096477,
    "Duration": "42.4930",
    "Fps": "25.0000",
    "AudioStreamList": [
      {
        "Index": "0",
        "Timebase": "0.000000",
        "SampleFmt": "fltp",
        "SampleRate": "44100",
        "ChannelLayout": "mono",
        "Lang": "und",
        "CodecLongName": "AAC (Advanced Audio Coding)",
        "Channels": "1",
        "NumFrames": "1",
        "Bitrate": "62.885",
        "CodecTagString": "mp4a",
        "StartTime": "2017-01-11T12:00:00Z",
        "CodecName": "aac",
        "Duration": "3.227574",
        "CodecTag": "0x6134706d",
        "CodecTimeBase": "1/44100"
      }
    ],
    "VideoStreamList": [
      {
        "Timebase": "0.000000",
        "Index": "1",
        "AvgFPS": "30.0",
        "PixFmt": "yuv420p",
        "Lang": "und",
        "Sar": "0:1",
        "Height": "320",
        "CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
        "NumFrames": "0",
        "Bitrate": "500",
        "Rotate": "90",
        "CodecTagString": "avc1",
        "HasBFrames": "0",
        "Profile": "Main",
        "StartTime": "2017-01-11T12:00:00Z",
        "Dar": "0:1",
        "CodecName": "h264",
        "Width": "568",
        "Duration": "3.166667",
        "Fps": "30.0",
        "CodecTag": "0x31637661",
        "CodecTimeBase": "1/60",
        "Level": "30",
        "HDRType": "HDR"
      }
    ],
    "StorageClass": "Standard",
    "RestoreStatus": "Success",
    "RestoreExpiration": "2023-03-30T10:14:14Z",
    "FileMD5": ""
  }
}

    エラーコード

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

    変更履歴

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