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)/upload/signed-url endpoint.
Pricing:
- API calls are free
- Storage fee: $0.001/1GB per day
Workflow
- Get a signed URL and
asset_idfrom/upload/signed-url - Use the signed URL to upload your file directly to storage
- Verify upload completion via
/get-metadata(poll untilupload_statusisSUCCESS)
Complete Example (Ready to Test)
Here’s a complete example that shows how to get a signed URL and use it for upload:Code Examples (Using Existing Signed URL)
Parameters
Response
Returns HTTP status code and response text from the storage service. Success Response (200):Confirming Upload Completion
After uploading via the signed URL, the MAVI backend automatically detects the file. Use the Get Metadata endpoint with theasset_id (returned in Step 1) to verify the upload is complete:
Notes
- This upload happens directly to cloud storage (e.g., GCS)
- No authentication headers needed — the URL contains the signature
- Signed URLs expire after the time specified in
expires_in(typically 26 hours) - Make sure to upload the file before the URL expires
- Supports files up to 5 GB (for files under 500 MB, you can also use the simpler direct upload)
