Upload Video from URL

post/serve/api/v1/upload_url

Request

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

Request body application/x-www-form-urlencoded

urlstring uri required

Direct URL of the video. Must be reachable via unauthenticated HTTP GET.

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

Whether to retain the original source video. Defaults to true.

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

{
  "url": "https://example.com/test_video.mp4",
  "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.