接口功能介绍

用户可在点播模式下通过本接口获取媒体库的视频条目的具体信息。

接口约束

本接口的单用户QPS限制为20次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。

URI

POST /video/get

请求体body参数

响应参数

表 data

表 category

表 child

表instance

表 metaData

请求示例

{
    "videoId": "34c71dba-f280-4f5e-a05f-f4daed837fef",
}

响应示例

{
    "code": "0",
    "data": {
        "category": {
            "child": {
                "child": {
                    "id": 100000077934,
                    "name": "国产",
                    "parentId": 100000077933
                },
                "id": 100000077933,
                "name": "2024",
                "parentId": 100000077932
            },
            "id": 100000077932,
            "name": "励志片",
            "parentId": 0
        },
        "coverUrl": "https://default-data.oss.xstore.ctyun.cn/default-cover.png",
        "createTime": "2026-04-09 14:45:19",
        "instance": {
            "id": "306456816628",
            "name": "主实例"
        },
        "metaData": "{\"format\":{\"bit_rate\":\"1279457\",\"duration\":\"5.000000\",\"format_long_name\":\"QuickTime / MOV\",\"format_name\":\"mov,mp4,m4a,3gp,3g2,mj2\",\"nb_programs\":0,\"nb_stream_groups\":0,\"nb_streams\":2,\"probe_score\":100,\"size\":\"799661\",\"start_time\":\"0.000000\",\"tags\":{\"compatible_brands\":\"isomiso2avc1mp41\",\"encoder\":\"Lavf58.20.100\",\"major_brand\":\"isom\",\"minor_version\":\"512\"}},\"streams\":[{\"avg_frame_rate\":\"25/1\",\"bit_rate\":\"1140995\",\"bits_per_raw_sample\":\"8\",\"chroma_location\":\"left\",\"closed_captions\":0,\"codec_long_name\":\"H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10\",\"codec_name\":\"h264\",\"codec_tag\":\"0x31637661\",\"codec_tag_string\":\"avc1\",\"codec_type\":\"video\",\"coded_height\":720,\"coded_width\":1280,\"display_aspect_ratio\":\"16:9\",\"disposition\":{\"attached_pic\":0,\"captions\":0,\"clean_effects\":0,\"comment\":0,\"default\":1,\"dependent\":0,\"descriptions\":0,\"dub\":0,\"forced\":0,\"hearing_impaired\":0,\"karaoke\":0,\"lyrics\":0,\"metadata\":0,\"multilayer\":0,\"non_diegetic\":0,\"original\":0,\"still_image\":0,\"timed_thumbnails\":0,\"visual_impaired\":0},\"duration\":\"5.000000\",\"duration_ts\":64000,\"extradata_size\":43,\"field_order\":\"progressive\",\"film_grain\":0,\"has_b_frames\":2,\"height\":720,\"id\":\"0x1\",\"index\":0,\"is_avc\":\"true\",\"level\":31,\"nal_length_size\":\"4\",\"nb_frames\":\"125\",\"pix_fmt\":\"yuv420p\",\"profile\":\"High\",\"r_frame_rate\":\"25/1\",\"refs\":1,\"sample_aspect_ratio\":\"1:1\",\"start_pts\":0,\"start_time\":\"0.000000\",\"tags\":{\"handler_name\":\"VideoHandler\",\"language\":\"eng\",\"vendor_id\":\"[0][0][0][0]\"},\"time_base\":\"1/12800\",\"width\":1280},{\"avg_frame_rate\":\"0/0\",\"bit_rate\":\"129188\",\"bits_per_sample\":0,\"channel_layout\":\"stereo\",\"channels\":2,\"codec_long_name\":\"AAC (Advanced Audio Coding)\",\"codec_name\":\"aac\",\"codec_tag\":\"0x6134706d\",\"codec_tag_string\":\"mp4a\",\"codec_type\":\"audio\",\"disposition\":{\"attached_pic\":0,\"captions\":0,\"clean_effects\":0,\"comment\":0,\"default\":1,\"dependent\":0,\"descriptions\":0,\"dub\":0,\"forced\":0,\"hearing_impaired\":0,\"karaoke\":0,\"lyrics\":0,\"metadata\":0,\"multilayer\":0,\"non_diegetic\":0,\"original\":0,\"still_image\":0,\"timed_thumbnails\":0,\"visual_impaired\":0},\"duration\":\"5.000000\",\"duration_ts\":220500,\"extradata_size\":5,\"id\":\"0x2\",\"index\":1,\"initial_padding\":0,\"nb_frames\":\"217\",\"profile\":\"LC\",\"r_frame_rate\":\"0/0\",\"sample_fmt\":\"fltp\",\"sample_rate\":\"44100\",\"start_pts\":0,\"start_time\":\"0.000000\",\"tags\":{\"handler_name\":\"SoundHandler\",\"language\":\"und\",\"vendor_id\":\"[0][0][0][0]\"},\"time_base\":\"1/44100\"}]}",
        "name": "720p_fast_start-1.mp4",
        "remark": "",
        "status": "UNAUDITED",
        "tags": [
            ""
        ],
        "uploadStatus": "UPLOAD_SUCCESS",
        "videoId": "7708530b3fc547fa9cc2a9cfbeb159ee",
        "videoUrl": "https://vod-origin-cy25.oss.ctyun.cn/7708530b3fc547fa9cc2a9cfbeb159ee.mp4"
    },
    "message": ""
}

状态码

错误码

OpenAPI错误码请参考 错误码说明。