Skip to main content
POST
Extract Video Frames
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)
This endpoint automatically extracts frames from a video file at regular intervals.
This is an async endpoint. You must configure a webhook URL in Webhooks Settings before calling this endpoint, otherwise you will not receive the processing results. See Webhooks Configuration Guide for details.
Pricing:
  • $0.01/second of video

Code Examples

Request Body

Response

Returns task information for the frame extraction operation.

Response Parameters

Callback Response Parameters

When the frame extraction is complete, a callback will be sent to your configured webhook URL.

Using the Returned IDs

Frame IDs follow the pattern imc_<parent_id>_<frame_index> (0-indexed).

Authorizations

Authorization
string
header
required

Body

application/json
asset_id
string
required

The video asset ID to extract frames from

Example:

"re_657739295220518912"

Response

200 - application/json

Frame extraction initiated successfully

code
string

Response code indicating the result status

Example:

200

msg
string

Response message describing the operation result

Example:

"success"

data
object

Response data object containing task information

success
boolean

Indicates whether the operation was successful

Example:

true

failed
boolean

Indicates whether the operation failed

Example:

false