tencent cloud

Feedback

Media Information APIs

Last updated: 2022-05-24 16:35:05

    Overview

    This document provides an overview of APIs and SDK code samples for media information.

    Note:

    The COS Python SDK version must be at least v5.1.9.11.

    API Operation Description
    GetMediaInfo Querying file information Queries media file information
    Note:

    Before using this API, make sure that the media processing feature has been enabled in the data processing section in the console; otherwise, the error media bucket unbinded, bucket's host is unavailable will be reported. For more information, see Enabling Media Processing.

    Querying File Information

    Feature description

    This API is used to query the information of a media file.

    Method prototype

    def get_media_info(Bucket, Key, **kwargs)
    

    Sample request

    response = client.get_media_info(
       Bucket=bucket_name,
       Key='demo.mp4'
    )
    print(response)
    

    Parameter description

    Parameter Description Required Type
    Bucket Bucket name in the format of BucketName-APPID. For more information, see Bucket Overview. Yes String
    Key Object key, which is the unique identifier of the object in the bucket. Yes String

    Response description

    {
    'MediaInfo': [{
    'Format': {
        'Bitrate': '16869.432000',
        'Duration': '129.200000',
        'FormatLongName': 'QuickTime / MOV',
        'FormatName': 'mov,mp4,m4a,3gp,3g2,mj2',
        'NumProgram': '0',
        'NumStream': '2',
        'Size': '272441346',
        'StartTime': '0.000000'
    },
    'Stream': {
        'Audio': {
            'Bitrate': '125.712000',
            'Channel': '2',
            'ChannelLayout': 'stereo',
            'CodecLongName': 'AAC (Advanced Audio Coding)',
            'CodecName': 'aac',
            'CodecTag': '0x6134706d',
            'CodecTagString': 'mp4a',
            'CodecTimeBase': '1/44100',
            'Duration': '129.160998',
            'Index': '0',
            'Language': 'und',
            'SampleFmt': 'fltp',
            'SampleRate': '44100',
            'StartTime': '0.000000',
            'Timebase': '1/44100'
        },
        'Subtitle': None,
        'Video': {
            'AvgFps': '30/1',
            'Bitrate': '16738.543000',
            'CodecLongName': 'H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10',
            'CodecName': 'h264',
            'CodecTag': '0x31637661',
            'CodecTagString': 'avc1',
            'CodecTimeBase': '1/600',
            'Duration': '129.200000',
            'Fps': '30.500000',
            'HasBFrame': '1',
            'Height': '1920',
            'Index': '1',
            'Language': 'und',
            'Level': '40',
            'NumFrames': '3876',
            'PixFormat': 'yuvj420p',
            'Profile': 'High',
            'RefFrames': '1',
            'Rotation': '0.000000',
            'StartTime': '0.000000',
            'Timebase': '1/600',
            'Width': '1080'
        }
    }
    }]
    }
    

    The nodes are as described below:

    MediaInfo has the following sub-nodes:

    Node Name (Keyword) Parent Node Description Type
    Stream MediaInfo Stream information. dict
    Format MediaInfo Format information. dict

    Stream has the following sub-nodes:

    Node Name (Keyword) Parent Node Description Type
    Video MediaInfo.Stream Video information. dict
    Audio MediaInfo.Stream Audio information. dict
    Subtitle MediaInfo.Stream Subtitles information. dict

    Format has the following sub-nodes (certain nodes may not be returned during video information query):

    Node Name (Keyword) Parent Node Description Type
    NumStream MediaInfo.Format Number of streams (including videos, audios, and subtitles). String
    NumProgram MediaInfo.Format Number of programs. String
    FormatName MediaInfo.Format Container format name. String
    FormatLongName MediaInfo.Format Detailed name of the container format. String
    StartTime MediaInfo.Format Start time in seconds. String
    Duration MediaInfo.Format Duration in seconds. String
    Bitrate MediaInfo.Format Bitrate in Kbps. String
    Size MediaInfo.Format Size in bytes. String

    Video has the following sub-nodes (certain nodes may not be returned during video information query):

    Node Name (Keyword) Parent Node Description Type
    Index MediaInfo.Stream.Video Stream number. String
    CodecName MediaInfo.Stream.Video Codec format name. String
    CodecLongName MediaInfo.Stream.Video Detailed name of the codec format. String
    CodecTimeBase MediaInfo.Stream.Video Codec timebase. String
    CodecTagString MediaInfo.Stream.Video Codec tag name. String
    CodecTag MediaInfo.Stream.Video Codec tag. String
    Profile MediaInfo.Stream.Video Video codec profile. String
    Height MediaInfo.Stream.Video Video height in px. String
    Width MediaInfo.Stream.Video Video width in px. String
    HasBFrame MediaInfo.Stream.Video Whether B-frames exist. 1: yes; 0: no. String
    RefFrames MediaInfo.Stream.Video Number of reference frames for video codec. String
    Sar MediaInfo.Stream.Video Sample aspect ratio. String
    Dar MediaInfo.Stream.Video Display aspect ratio. String
    PixFormat MediaInfo.Stream.Video Pixel format. String
    FieldOrder MediaInfo.Stream.Video Field order. String
    Level MediaInfo.Stream.Video Video codec level. String
    Fps MediaInfo.Stream.Video Video frame rate. String
    AvgFps MediaInfo.Stream.Video Average frame rate. String
    Timebase MediaInfo.Stream.Video Timebase. String
    StartTime MediaInfo.Stream.Video Video start time in seconds. String
    Duration MediaInfo.Stream.Video Video duration in seconds. String
    Bitrate MediaInfo.Stream.Video Bitrate in Kbps. String
    NumFrames MediaInfo.Stream.Video Total number of frames. String
    Language MediaInfo.Stream.Video Language. String

    Audio has the following sub-nodes (certain nodes may not be returned during video information query):

    Node Name (Keyword) Parent Node Description Type
    Index MediaInfo.Stream.Audio Stream number. String
    CodecName MediaInfo.Stream.Audio Codec format name. String
    CodecLongName MediaInfo.Stream.Audio Detailed name of the codec format. String
    CodecTimeBase MediaInfo.Stream.Audio Codec timebase. String
    CodecTagString MediaInfo.Stream.Audio Codec tag name. String
    CodecTag MediaInfo.Stream.Audio Codec tag. String
    SampleFmt MediaInfo.Stream.Audio Sample format. String
    SampleRate MediaInfo.Stream.Audio Sample rate. String
    Channel MediaInfo.Stream.Audio Number of channels. String
    ChannelLayout MediaInfo.Stream.Audio Channel layout. String
    Timebase MediaInfo.Stream.Audio Timebase. String
    StartTime MediaInfo.Stream.Audio Audio start time in seconds. String
    Duration MediaInfo.Stream.Audio Audio duration in seconds. String
    Bitrate MediaInfo.Stream.Audio Bitrate in Kbps. String
    Language MediaInfo.Stream.Audio Language. String

    Subtitle has the following sub-nodes:

    Node Name (Keyword) Parent Node Description Type
    Index MediaInfo.Stream.Subtitle Stream number. String
    Language MediaInfo.Stream.Subtitle Language. und indicates no query result. String
    Contact Us

    Contact our sales team or business advisors to help your business.

    Technical Support

    Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

    7x24 Phone Support