BRbraiv
Dubs

Create dubs

Queues one dub job per target language using the selected voice product and source voiceover track. Required scope: dubs:write.

post/videos/{videoId}/dubs

Request

  • Base URL
    https://api.braiv.co/v1
  • Auth
    • HTTP bearer
    • or API key in header X-Api-Key

Path parameters

videoIdstring required

Braiv library video document ID.

Headers

Idempotency-Keystring

Caller-generated key for safe POST retries. The API retains the first JSON response for 24 hours. Reusing a key with another path or body returns 409 IDEMPOTENCY_REPLAY.

Request body

languagesLanguageCode[] required

Unique dub target languages.

product'plus' | 'premium'

Dubbing voice product:

  • plus — expressive multilingual dubbing using a Braiv voice.
  • premium — dubbing with a cloned voice created from each speaker's source samples.
sourceVoiceover'original' | 'optimized'

Source narration used to produce the dub: original uses the video's source transcript and narration; optimized uses the latest ready Optimize/redub transcript. Choose optimized only after that workflow is ready.

reservationIdstring

Optional credit escrow to consume.

reservationLineItemIdByLanguageobject

Reservation line-item IDs keyed by requested language.

Example request

{
  "languages": [
    "en"
  ]
}

Response

Dub jobs queued.

videoIdstring required

Parent library video ID.

balancenumber

Remaining credit balance when returned by the dubbing service.

Example response

{
  "jobs": [
    {
      "language": "en"
    }
  ]
}

Changes

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