Upload File
Asset Management
Upload File
Upload a video, audio, or image file to Visual Intelligence for processing and analysis.
POST
Upload File
Product: Visual Intelligence — Asset Management
Use case: Upload, manage, and download video/image assets used by other Visual Intelligence APIs
Host:
https://mavi-backend.memories.ai/serve/api/v2
Auth: Authorization: sk-mavi-... (no Bearer prefix)asset_id that can be used to reference this asset in all subsequent API calls.
Pricing:
- API calls are free
- Storage fee: $0.001/1GB per day
Supported File Formats
Code Example
Request Body
Response
Return the resource information after the upload is successful.Response Parameters
Error Responses
HTTP 400 with a generic "Request has exceeded the limit." body — that string is shared between rate-limit and several validation paths, so don’t parse msg to distinguish them; rely on the HTTP status code.
Upload Status
After uploading, the asset goes through the following states. Only assets withSUCCESS status can be used in subsequent API calls.
Use the Get Metadata endpoint to check the current
upload_status of an asset.
File Size Limit
Notes
- The returned
asset_idis required for all subsequent operations (transcription, editing, embedding, etc.) - Only assets with
upload_status: "SUCCESS"can be used in subsequent API calls - Use Get Metadata to verify the asset is ready before calling other endpoints
Authorizations
Body
multipart/form-data
The file to upload
Response
200 - application/json
File uploaded successfully
Response code indicating the result status
Example:
200
Response message describing the operation result
Example:
"success"
Response data object containing the uploaded asset information
Indicates whether the operation was successful
Example:
true
Indicates whether the operation failed
Example:
false
