API REFERENCE · DUBBING
Outputs & subtitles
Per language: the video up to 4K, subtitles, a true 5.1 or stereo mix, the voice track, translated metadata.
01.Download an output
/v1/dubs/{dub_id}/output/{lang}curl -L https://api.thefamiliarlab.com/v1/dubs/dub_31xk9m/output/es \ -H "Authorization: Bearer $FAMILIAR_API_KEY" \ -o dubbed-es.mp4
Redirects (302) to a signed URL for the finished video (mp4; ProRes masters on Studio deliveries); signed URLs expire after one hour, so re-request rather than store them. A language that isn't complete yet returns 409; the dub.output_ready webhook fires per language the moment it lands (Webhooks).
| PARAM | TYPE | DESCRIPTION |
|---|---|---|
format | string | mp4 (default, the video) · srt · vtt (subtitles) · audio (full mix, 24-bit PCM wav) · voice (voice track alone, wav). |
02.Subtitles
/v1/dubs/{dub_id}/output/{lang}?format=srt1 00:00:12,480 --> 00:00:15,910 Ese es todo el truco.
Included with every dub, and the whole output of subtitles_onlyjobs; source-language subtitles ride the same route with the source's code. Subtitle text comes from the review step, so a subtitle job always pauses at in_review before its files exist (Transcript & review).
03.Audio tracks
/v1/dubs/{dub_id}/output/{lang}?format=audiocurl -L "https://api.thefamiliarlab.com/v1/dubs/dub_31xk9m/output/es?format=voice" \ -H "Authorization: Bearer $FAMILIAR_API_KEY" \ -o dubbed-es.voice.wav
audio is the finished mix as 24-bit PCM WAV, true 5.1 surround or stereo chosen per job (the default follows the source), for platforms that accept extra audio tracks and for audio-only distribution; voice is the dubbed voice track alone, no scene bed, for your own mix. Both use the same 302 signed-URL redirect as the video and land with it under one dub.output_ready webhook.
04.Translated metadata
If the dub was created with metadata.title / metadata.description, every language's output arrives with its own translated pair (Metadata translation).
05.Retention
Outputs stay downloadable until you delete the dub (DELETE /v1/dubs/{dub_id}, Delete a dub).
06.Access
The API is enterprise-only: private access under a Studio contract, with volume pricing, raised limits, ProRes masters on request, and a named point of contact. Book a call and your key is issued with the contract.