v1

latestOpenAPI 3.1.02026-07-2665164286.3 KB

Video Translate

Create Proofread Session

Creates a proofread session that extracts editable subtitles from a video before final rendering.

post/v3/video-translations/proofreads

Headers

Idempotency-Keystring

Optional client-supplied key for safely retrying mutations. Subsequent calls within 24 hours that share this key replay the original response — even if the request body differs slightly (a warning is logged). A retry that arrives while the original is still in flight gets a 409 request_in_progress. Keys must be 1–255 characters from [A-Za-z0-9_:.-]; a UUID is a safe default. Scope is per-endpoint and per-resource: the same key on a different route or path parameter is independent.

Request body

output_languagesstring[] required

Target language codes. Use one for single proofread, multiple for batch.

titlestring required

Title for the proofread job

brand_voice_idstring nullable

Brand glossary ID for custom term translations. Legacy field name for brand_glossary_id — both are accepted and resolve to the same workspace record. Discover IDs via GET /v3/brand-glossaries.

brand_glossary_idstring nullable

Brand glossary ID for custom term translations (e.g. translate 'Reformer' as 'Pilates equipment', not 'political activist'). Alias for the legacy brand_voice_id field. Discover IDs via GET /v3/brand-glossaries.

speaker_numinteger nullable

Number of speakers (improves speaker separation)

folder_idstring nullable

Project/folder ID to organize proofread into

enable_video_stretchingboolean

Allow dynamic duration adjustment

disable_music_trackboolean

Remove background music

enable_speech_enhancementboolean

Enhance speech quality

mode'speed' | 'precision'

keep_the_same_formatboolean

Preserve the source video's encoding specs (resolution, bitrate)

Response

Successful response