transcribe media
The words in audio and video, with timing. One ref: 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. refs, up to 20: the words already stored on each file, never transcribing; each row carries state: has_words, being_transcribed or held (with job_id), none_yet (with the estimate), no_speech or no_audio. timeline_id: transcribes every uploaded clip on the timeline whose words are unknown, which is what captions, get_transcript and remove_words read. 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 default: for a key or a connected agent, one of the workspaces the user allowed it.
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 is its own row.
1 - 20 elementsTranscribe the uploaded clips on this timeline that have no words yet, and give them the words.
With timeline_id: only these clips, read and charged again even if they have words, the way back from a transcript speech recognition got wrong.
ref: 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. states, with refs: where each file's words stand, no words.
sentences, lines, phrases, states ref: return only from this second. The whole file is still read.
x >= 0ref: 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.
Only the speech touching this span of the file, in seconds. Lines stop at about 100,000 characters, an hour of speech or more, and next_start names where the next window begins.
Optional: one sentence shown to the user beside this action.
600
