Skip to main content
GET
Get video transcription
Retrieve the timestamped transcription for a video. Supports multiple segmentation types and time ranges.

Parameters

  • SDK helpers return a list of dicts with start (float), end (float), and text (str) for each segment
  • The raw API response wraps this as data.word_timestamps plus data.text
  • Transcription segmentation is audio/text-based and is independent of visual scene segmentation
  • Invalid segmenter values raise a ValueError
  • Negative start/end or start > end raise a ValueError
  • Generates transcript automatically if not already created

Raw response shape

When completed, the server returns transcript text and timestamped entries:
Silence ranges may be included with text: "-".

Authorizations

x-access-token
string
header
required

API key for authentication (sk-xxx format)

Path Parameters

video_id
string
required
Pattern: ^m-
Example:

"m-12345"

Query Parameters

engine
string
default:default
Example:

"default"

start
number
default:0
Example:

10.5

end
number
default:-1
Example:

60

segmenter
string
default:word
Example:

"word"

length
integer
default:1
Example:

1

Response

200 - application/json

Transcription data

success
boolean
Example:

true

status
enum<string>
Available options:
completed,
processing,
failed
Example:

"completed"

data
object