POST
/
upload
Upload File
curl --request POST \
  --url https://mavi-backend.memories.ai/serve/api/v2/upload \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: multipart/form-data' \
  --form file='@example-file'
{
  "code": "0000",
  "msg": "success",
  "data": {
    "asset_id": "re_660727003963174912"
  },
  "success": true,
  "failed": false
}
This endpoint allows you to upload a file to the server.

​
Code Example

import requests

BASE_URL = "https://mavi-backend.memories.ai/serve/api/v2"
API_KEY = "sk-8483027fe3abfe535f6ae01a9979b4f7"
HEADERS = {
    "Authorization": f"{API_KEY}"
}

def upload(file_path):
    url = f"{BASE_URL}/upload"
    files = {"file": open(file_path, "rb")}
    response = requests.post(url, headers=HEADERS, files=files)
    return response.json()

# Usage example
result = upload("video.mp4")
print(result)

​
Request Body

ParameterTypeRequiredDescription
filefileYesThe file to upload (supports various file formats)

​
Response

Return the resource information after the upload is successful. 
{
  "code": "0000",
  "msg": "success",
  "data": {
    "asset_id": "re_660727003963174912"
  },
  "success": true,
  "failed": false
}

​
Response Parameters

ParameterTypeDescription
codestringResponse code indicating the result status
msgstringResponse message describing the operation result
dataobjectResponse data object containing the uploaded asset information
data.asset_idstringUnique identifier of the uploaded asset
successbooleanIndicates whether the operation was successful
failedbooleanIndicates whether the operation failed

Authorizations

​
Authorization
string
header
required

Body

multipart/form-data
​
file
file
required

The file to upload

Response

200 - application/json

File uploaded successfully

​
code
string

Response code indicating the result status

Example:

"0000"

​
msg
string

Response message describing the operation result

Example:

"success"

​
data
object

Response data object containing the uploaded asset information

​
success
boolean

Indicates whether the operation was successful

Example:

true

​
failed
boolean

Indicates whether the operation failed

Example:

false