Upload Video from File

post/serve/api/v1/upload

Request

  • Base URL
    https://mavi-backend.memories.ai/serve/api/v2
  • Auth
    API key in header Authorization

Request body multipart/form-data

filestring binary required

Video file to upload. Allowed extensions: .mp4, .avi, .mkv, .mov. Content-Type must start with video/. Max size 3 GB.

callbackstring uri

Callback URL invoked when the video moves to the parsing stage. Max 299 characters.

datetime_takenstring

Capture time in format yyyy-MM-dd HH:mm:ss.

camera_modelstring

Camera/device model. Max 200 characters.

latitudenumber double
longitudenumber double
tagsstring[]

User-defined tags. Max 20. The server automatically appends an 'api' tag.

retain_original_videoboolean
video_transcription_promptstring
folder_idinteger

Optional target folder for the upload. Omit or pass -1 for the account's Default folder (auto-created on first use). A positive id must belong to your account.

Example request

{
  "callback": "https://your.app/callback",
  "datetime_taken": "2025-10-20 11:00:00",
  "camera_model": "Canon EOS 5D",
  "latitude": 66.66,
  "longitude": 66.66,
  "tags": [
    "test1",
    "test2"
  ],
  "video_transcription_prompt": "Focus on the speaker and major scene changes.",
  "folder_id": 671631448308117500
}

Response

Successful response

codestring

Business status code. 0000 indicates success.

msgstring
successboolean
failedboolean

Example response

{
  "code": "0000",
  "msg": "success",
  "data": {
    "videoNo": "VI568102998803353600",
    "videoName": "1be6a69f3c6e49bf986235d68807ab1f",
    "videoStatus": "UNPARSE",
    "uploadTime": "1744905509814"
  },
  "success": true,
  "failed": false
}

Changes

No recorded changes to this operation across all 1 revision of this API.