v1

latestOpenAPI 3.1.02026-07-266827131.9 KB

List Videos in Folder

get/serve/api/v1/folders/videos

Query parameters

folder_idinteger required

Folder to list. -1 Default folder, -2 legacy API folder, or a folder that belongs to your account.

pageinteger

One-based page number.

page_sizeinteger

Items per page.

Response

Successful response

codestring
msgstring
successboolean
failedboolean

Example response

{
  "code": "0000",
  "msg": "success",
  "data": {
    "current_page": 1,
    "page_size": 20,
    "total_count": 2,
    "videos": [
      {
        "video_no": "VI606404158946574336",
        "video_name": "182082-867762198_tiny",
        "duration": 12,
        "size": 3284512,
        "status": "PARSE",
        "create_time": 1754037217992,
        "datetime_taken": 1729388400000,
        "camera_model": "Canon EOS 5D",
        "latitude": 39.9042,
        "longitude": 116.4074,
        "tags": [
          "holiday",
          "beijing",
          "api"
        ],
        "bucket": "mavi-resource",
        "blob": "VI606404158946574336.mp4"
      },
      {
        "video_no": "VI606402870447996928",
        "video_name": "test_video_gz_visual_understanding_s36",
        "duration": 61,
        "size": 5324808,
        "status": "PARSE",
        "create_time": 1754036910783,
        "bucket": "mavi-resource",
        "blob": "VI606402870447996928.mp4"
      }
    ]
  },
  "success": true,
  "failed": false
}