Transcribe

Field notes. start_ms is the load-bearing number: end_ms carries a min_word_duration_ms floor and may therefore overrun the next word's start, so build highlight windows with [word.start_ms, next_word.start_ms) as /v1/render-profile describes. boundaries_estimated: true means word boundaries for this request are approximate; it is only ever returned for space-separated languages, and a request that cannot be given reliable boundaries fails with a retryable 503 rather than returning poor ones. Subtitle exports are always generated from the unshifted timeline, even when bake_lead shifts words and segments, because a burned-in or <track>-rendered caption has no decode latency to compensate for.

post/v1/transcribe

Request

  • Base URL
    https://api.doomersion.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.doomersion.com/v1/transcribe
  • Auth
    none declared

Headers

X-API-Keystring nullable
authorizationstring nullable

Request body multipart/form-data

filestring binary required

Audio or video file (any container ffmpeg reads)

tierstring

'accurate' (word-level boundaries and sentence segments; required for languages written without spaces) or 'fast' (cheaper and quicker; equivalent word timings on space-separated languages, character-level units on unspaced ones)

languagestring nullable

Optional ISO language hint (fast tier only)

preprocessboolean

Denoise + normalize before transcription

bake_leadboolean

Pre-shift timings by our recommended lead

lead_msinteger nullable

Explicit lead to pre-shift by (implies bake_lead)

formatsstring nullable

Comma-separated subtitle exports: srt,vtt,ass

freshboolean

Force reprocessing instead of replaying an identical recent upload

backgroundboolean

Return 202 + request_id immediately instead of waiting for the result

translate_tostring nullable

Optional target language for sentence-level translation of each segment: 'en'. Word timings stay in the source language

Response

Word timings, caption segments, render constants, and any requested subtitle exports.

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.