transcribe media
The words in audio and video, with timing. One ref or url: a timestamped transcript, sentence-level (word-level with include_words); media under five minutes answers in the call, longer returns a job and a second call after it finishes returns the words. Cached per library item, so a repeat read costs nothing; a url outside the workspace is read again every call. refs, up to 20: the words already stored on each file, never transcribing; a file nobody has read comes back unread. timeline_id: transcribes every uploaded clip on the timeline whose words are unknown and writes them onto the clips, which is what captions, get_transcript and remove_words read. format lines is the compact form for reading a long file whole; phrases marks the pauses, for choosing cut points. Cloud processing.
Authorizations
An API key (es_live_…) from Settings, under API keys, or an OAuth access token.
Headers
Retry a paid dispatch safely: the same key returns the job already dispatched instead of charging again.
The workspace this one call acts in, when it is not the key's own.
Body
An item ref, item id, or the job id that made it.
Up to 20 audio or video items: their stored words, free. One that cannot be read comes back as its own row beside the rest.
1 - 20 elementsTranscribe the uploaded clips on this timeline that have no words yet, and write the words onto them.
With timeline_id: only these clips, read again from scratch even if they have words, the way back from a transcript speech recognition got wrong.
ref or url: word-level timing as well as sentences.
sentences (default): each with start and end. lines: one timed line per sentence as one string, half the size, for reading a long file whole. phrases: speech broken at pauses, each with the gap after it, for choosing cut points.
sentences, lines, phrases ref or url: return only from this second. The whole file is still read.
x >= 0ref or url: return only up to this second.
x >= 0format phrases: a pause this long or longer breaks one phrase from the next. Default 400; 700 and up finds only the breaths between takes.
0 <= x <= 10000format phrases: name who is talking on each phrase, from the voices the speakers tool picked out. A file nobody has been picked out of has none; this never listens to find out.
format phrases: only phrases touching this span of the file, in seconds.
Optional: one sentence shown to the user beside this action.
600
