接口功能介绍

用户可通过本接口查询媒体库的视频条目。

接口约束

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

URI

POST /video/search

请求体body参数

响应参数

表data

表 category

表 child

表instance

表metaData

请求示例

{
    "name": "",
    "instanceId": 4546077670,
    "categoryId"：10000612,
    "pageSize": 10,
    "pageIndex": 0
}

响应示例

{
  "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.store:10003/7708530b3fc547fa9cc2a9cfbeb159ee.mp4"
    }
  ],
  "message": ""
} 

状态码

错误码

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