Get Audio Transcription

curl --request GET \
  --url https://api.memories.ai/serve/api/v1/get_audio_transcription \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.memories.ai/serve/api/v1/get_audio_transcription', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.memories.ai/serve/api/v1/get_audio_transcription",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.memories.ai/serve/api/v1/get_audio_transcription"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.memories.ai/serve/api/v1/get_audio_transcription")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "code": "0000",
  "msg": "success",
  "data": {},
  "success": true,
  "failed": false
}

GET

serve

api

get_audio_transcription

Get Audio Transcription

curl --request GET \
  --url https://api.memories.ai/serve/api/v1/get_audio_transcription \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.memories.ai/serve/api/v1/get_audio_transcription', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.memories.ai/serve/api/v1/get_audio_transcription",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.memories.ai/serve/api/v1/get_audio_transcription"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.memories.ai/serve/api/v1/get_audio_transcription")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "code": "0000",
  "msg": "success",
  "data": {},
  "success": true,
  "failed": false
}

Product: Visual Search Use case: Upload videos and images, auto-index them, then search by natural language, image, or transcript phrase Host: https://api.memories.ai/serve/api/v1 Auth: Authorization: sk-mavi-... (no Bearer prefix)

Retrieve the audio transcription (speech-to-text) of a video’s audio track. Each segment carries a time range and the transcribed text. For the visual scene descriptions, use Get Video Caption.

Prerequisites

You have created a memories.ai API key.
The video has been uploaded via the Upload API and finished parsing.
The source video has an audio track. Videos without audio return data: null even when the request succeeds.

Endpoint

GET /serve/api/v1/get_audio_transcription

Request Example

import requests

url = "https://api.memories.ai/serve/api/v1/get_audio_transcription"
headers = {"Authorization": "sk-mavi-..."}
params = {
    "video_no": "VI605961375402668032",
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

Query Parameters

string

required

The video identifier returned by the upload API.

Response Example

Audio track present:

{
  "code": "0000",
  "msg": "success",
  "data": {
    "videoNo": "VI605961375402668032",
    "transcriptions": [
      {
        "index": 0,
        "content": " I'm going to get my emergency and report.",
        "startTime": "0",
        "endTime": "7"
      },
      {
        "index": 1,
        "content": " Mommy, you're going to go.",
        "startTime": "7",
        "endTime": "12"
      }
    ],
    "createTime": "1758276264066",
    "video_bucket": "mavi-resource",
    "video_blob": "VI605961375402668032.mp4"
  },
  "success": true,
  "failed": false
}

No audio track (or transcription not yet ready):

{
  "code": "0000",
  "msg": "success",
  "data": null,
  "success": true,
  "failed": false
}

Response Fields

string

Business status code. 0000 indicates success — including the “no audio track” case below.

string

Human-readable status message.

object | null

The transcription record, or null if the video has no audio track / no transcription has been produced. Check data is None explicitly rather than relying on the status code.

string

Echo of the requested video identifier.

array

Ordered list of transcription segments covering the audio track.

integer

Zero-based index of the segment.

string

Transcribed text for this segment (often with a leading space).

string

Segment start time in seconds, returned as a string.

string

Segment end time in seconds, returned as a string.

string

Upload-time timestamp of the underlying video, in milliseconds since epoch, returned as a string.

string

GCS bucket of the underlying video file. Omitted when the storage location cannot be resolved.

string

GCS blob (object) path of the underlying video. Use it with video_bucket at GET /serve/api/v2/download?bucket=&blob= to fetch the file directly.

boolean

true when code == "0000" — true even on the “no audio track” path.

boolean

Inverse of success.

Notes & Limits

No-audio case is not an error: Videos without an audio track return code: "0000", success: true, data: null. Check for data explicitly.
Numeric strings: startTime, endTime, and createTime are strings — cast with int(...) before arithmetic.
Rate limiting: Subject to the standard Visual Search rate limits. See Rate limits.

Authorizations

Authorization

string

header

required

Query Parameters

video_no

string

required

The unique video ID returned by the upload API.

Response

200 - application/json

Successful response

code

Example:

"0000"

msg

string

Example:

"success"

data

success

boolean

Example:

true

failed

boolean

Example:

false

Get Started

Index Upload

Search

Library Management

Folder Management

Reference

Get Audio Transcription

Prerequisites

Endpoint

Request Example

Query Parameters

Response Example

Response Fields

Notes & Limits

Authorizations

Query Parameters

Response

​Prerequisites

​Endpoint

​Request Example

​Query Parameters

​Response Example

​Response Fields

​Notes & Limits

Authorizations

Query Parameters

Response

Prerequisites

Endpoint

Request Example

Query Parameters

Response Example

Response Fields

Notes & Limits