Skip to main content
POST
Async Generate Video Transcription
Product: Visual Intelligence — Video Task APIs (application layer) Use case: Pre-packaged video analysis tasks built on top of the Video Model APIs — fixed prompt + workflow, you just POST a video and get a structured result. For full control over prompt and model selection, see Video Model APIs. Host: https://mavi-backend.memories.ai/serve/api/v2 Auth: Authorization: sk-mavi-... (no Bearer prefix)
Analyzes video frames using a Gemini model and produces timestamped descriptions of what is visually happening — scene changes, on-screen actions, objects — rather than transcribing spoken words. Not the same as Video Caption: Video Caption runs on a dedicated security.memories.ai service, supports Human ReID (named person identification), and requires a separate API key. Use Video Frame Description for standard frame-by-frame analysis on assets you’ve uploaded via the main API.
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:
  • Input tokens: $0.45/1M tokens
  • Output tokens: $3.75/1M tokens

Supported Models

  • gemini-2.5-flash-lite
  • gemini-2.5-flash
  • gemini-2.5-flash-preview-09-2025
  • gemini-2.5-flash-lite-preview-09-2025

Request Body

Code Example

Response

Returns the video description task information.

Response Parameters

Callback Response Parameters

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

Authorizations

Authorization
string
header
required

Body

application/json
asset_id
string
required

The video asset ID to transcribe

Example:

"re_657929111888723968"

model
string
required

The transcription model to use

Example:

"gemini-2.5-flash-lite"

Response

200 - application/json

Transcription task information

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