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

GET/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).

TABLE 01 · QUERY PARAMETERS
PARAMTYPEDESCRIPTION
formatstringmp4 (default, the video) · srt · vtt (subtitles) · audio (full mix, 24-bit PCM wav) · voice (voice track alone, wav).

02.Subtitles

GET/v1/dubs/{dub_id}/output/{lang}?format=srt
200 · TEXT/SRT
1
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

GET/v1/dubs/{dub_id}/output/{lang}?format=audio
curl -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.