Skip to main content
POST
Create dubs

Authorizations

Authorization
string
header
required

rk_live_… or rk_test_…, made in Reedapt under Developers.

Headers

idempotency-key
string | null

Any unique string, up to 255 characters. Sending the same request again with the same key returns the first answer instead of doing the work twice. Kept for 24 hours.

Example:

"7c1f6a52-2d4e-4bb1-9e0a-5f3d8c2b1a90"

Body

application/json
upload_id
string
required

An upload whose status is uploaded.

Example:

"job_3f9a2c7e1b4d"

source_language
string
required

The language spoken in the file, as a code like en.

Required string length: 2 - 10
Example:

"en"

target_languages
string[]
required

One dub is made per language. GET /languages lists the codes your plan has.

Required array length: 1 - 30 elements
Example:
voice_cloning
boolean
default:true

Dub in each speaker's own voice.

num_speakers
integer | null

How many people speak, if you know. Left out, we work it out.

Required range: 1 <= x <= 20
Example:

2

media_category
string | null

What the media is, e.g. film or sermon. Optional.

Maximum string length: 32
metadata
Metadata · object | null

Your own keys and values, up to 2 KB, returned on the dub and its webhooks.

Example:

Response

Successful Response

dubs
Dub · object[]
required

One per language that started.

refused
RefusedLanguage · object[]

Languages that could not be started. Nothing is reserved for them.