---
title: "Create a dubbing project from an uploaded video asset"
method: POST
path: "/v2/dubbing"
tags: ["Dubbing"]
---

# Create a dubbing project from an uploaded video asset

`POST /v2/dubbing`

Use this endpoint to create a dubbing project from an uploaded video asset. Currently only S3 signed URLs are supported (using other URLs will return a `501` error)

## Request body

- union
  - CreateDubbingProjectApiRequestFromSourceAssetId
    - `title` string, required — The title of the dubbed video to create.
    - `targetLanguages` DubbingOutputLanguage[], required — The languages to dub the source media asset to.
    - `lipsyncEnabled` boolean — Whether to enable lipsync for the dubbed video.
    - `videoDuration` 'adaptive' | 'original' — The duration of the video to create.
    - `visibility` 'private' | 'public' — The visibility of the dubbed video.
    - `sourceAssetId` string, required — The ID of the source media asset to create the dubbed video from.
    - `sourceLanguage` 'af' | 'sq' | 'am' | 'ar' | 'ar-DZ' | 'ar-BH' | 'ar-EG' | 'ar-IQ' | 'ar-JO' | 'ar-KW' | 'ar-LY' | 'ar-MA' | 'ar-QA' | 'ar-SA' | 'ar-SY' | 'ar-TN' | 'ar-AE' | 'ar-YE' | 'hy' | 'as' | 'az' | 'ba' | 'eu' | 'be' | 'bn' | 'bs' | 'br' | 'bg' | 'my' | 'ca' | 'zh' | 'zh-CN' | 'zh-HK' | 'zh-TW' | 'hr' | 'cs' | 'da' | 'nl' | 'nl-BE' | 'nl-NL' | 'en' | 'en-AU' | 'en-CA' | 'en-GB' | 'en-HK' | 'en-IN' | 'en-IE' | 'en-KE' | 'en-MX' | 'en-NZ' | 'en-NG' | 'en-PH' | 'en-SG' | 'en-ZA' | 'en-TZ' | 'en-US' | 'et' | 'fo' | 'fi' | 'fr' | 'fr-BE' | 'fr-CA' | 'fr-FR' | 'fr-CH' | 'gl' | 'ka' | 'de' | 'de-AT' | 'de-DE' | 'de-CH' | 'el' | 'gu' | 'ht' | 'ha' | 'haw' | 'he' | 'hi' | 'hu' | 'is' | 'id' | 'it' | 'ja' | 'jw' | 'kn' | 'kk' | 'km' | 'ko' | 'lo' | 'la' | 'lv' | 'ln' | 'lt' | 'lb' | 'mk' | 'mg' | 'ms' | 'ml' | 'mt' | 'mi' | 'mr' | 'mn' | 'ne' | 'no' | 'nb' | 'nn' | 'oc' | 'pa' | 'ps' | 'fa' | 'pl' | 'pt' | 'pt-BR' | 'pt-PT' | 'ro' | 'ru' | 'sa' | 'sr' | 'sn' | 'sd' | 'si' | 'sk' | 'sl' | 'so' | 'es' | 'es-AR' | 'es-BO' | 'es-CL' | 'es-CO' | 'es-CR' | 'es-CU' | 'es-DO' | 'es-EC' | 'es-SV' | 'es-GQ' | 'es-GT' | 'es-HN' | 'es-LA' | 'es-MX' | 'es-NI' | 'es-PA' | 'es-PY' | 'es-PE' | 'es-PR' | 'es-ES' | 'es-US' | 'es-UY' | 'es-VE' | 'su' | 'sw' | 'sv' | 'tl' | 'tg' | 'ta' | 'ta-IN' | 'ta-SG' | 'ta-LK' | 'tt' | 'te' | 'th' | 'bo' | 'tr' | 'tk' | 'uk' | 'ur' | 'uz' | 'vi' | 'cy' | 'yi' | 'yo', required
  - object — Create a dubbing project directly from a video URL. Only S3 signed URLs are supported (using other URLs will return a 501 error).
    - `title` string, required — The title of the dubbed video to create.
    - `targetLanguages` DubbingOutputLanguage[], required — The languages to dub the source media asset to.
    - `lipsyncEnabled` boolean — Whether to enable lipsync for the dubbed video.
    - `videoDuration` 'adaptive' | 'original' — The duration of the video to create.
    - `visibility` 'private' | 'public' — The visibility of the dubbed video.
    - `sourceVideoUrl` string, uri, required — The public URL where the video to dub is available. At the moment only supporting s3 signed urls
    - `sourceLanguage` 'af' | 'sq' | 'am' | 'ar' | 'ar-DZ' | 'ar-BH' | 'ar-EG' | 'ar-IQ' | 'ar-JO' | 'ar-KW' | 'ar-LY' | 'ar-MA' | 'ar-QA' | 'ar-SA' | 'ar-SY' | 'ar-TN' | 'ar-AE' | 'ar-YE' | 'hy' | 'as' | 'az' | 'ba' | 'eu' | 'be' | 'bn' | 'bs' | 'br' | 'bg' | 'my' | 'ca' | 'zh' | 'zh-CN' | 'zh-HK' | 'zh-TW' | 'hr' | 'cs' | 'da' | 'nl' | 'nl-BE' | 'nl-NL' | 'en' | 'en-AU' | 'en-CA' | 'en-GB' | 'en-HK' | 'en-IN' | 'en-IE' | 'en-KE' | 'en-MX' | 'en-NZ' | 'en-NG' | 'en-PH' | 'en-SG' | 'en-ZA' | 'en-TZ' | 'en-US' | 'et' | 'fo' | 'fi' | 'fr' | 'fr-BE' | 'fr-CA' | 'fr-FR' | 'fr-CH' | 'gl' | 'ka' | 'de' | 'de-AT' | 'de-DE' | 'de-CH' | 'el' | 'gu' | 'ht' | 'ha' | 'haw' | 'he' | 'hi' | 'hu' | 'is' | 'id' | 'it' | 'ja' | 'jw' | 'kn' | 'kk' | 'km' | 'ko' | 'lo' | 'la' | 'lv' | 'ln' | 'lt' | 'lb' | 'mk' | 'mg' | 'ms' | 'ml' | 'mt' | 'mi' | 'mr' | 'mn' | 'ne' | 'no' | 'nb' | 'nn' | 'oc' | 'pa' | 'ps' | 'fa' | 'pl' | 'pt' | 'pt-BR' | 'pt-PT' | 'ro' | 'ru' | 'sa' | 'sr' | 'sn' | 'sd' | 'si' | 'sk' | 'sl' | 'so' | 'es' | 'es-AR' | 'es-BO' | 'es-CL' | 'es-CO' | 'es-CR' | 'es-CU' | 'es-DO' | 'es-EC' | 'es-SV' | 'es-GQ' | 'es-GT' | 'es-HN' | 'es-LA' | 'es-MX' | 'es-NI' | 'es-PA' | 'es-PY' | 'es-PE' | 'es-PR' | 'es-ES' | 'es-US' | 'es-UY' | 'es-VE' | 'su' | 'sw' | 'sv' | 'tl' | 'tg' | 'ta' | 'ta-IN' | 'ta-SG' | 'ta-LK' | 'tt' | 'te' | 'th' | 'bo' | 'tr' | 'tk' | 'uk' | 'ur' | 'uz' | 'vi' | 'cy' | 'yi' | 'yo'

## Response `202`

Accepted - Dubbing project created successfully.

- CreateDubbingProjectApiResponseSuccess
  - `createdImportedAsset` ImportedAssetId, required
    - `id` string, uuid, required

## Other responses

- `400` — Bad Request - Failed to create dubbing project. This can occur when: - The request validation fails - The source asset video URL is broken or inaccessible - There are errors creating the dubbed videos
- `403` — Forbidden - Wrong API key.
- `404` — Asset ID was not found.
- `501` — Not Implemented
- `default` — Unexpected Server error.

---

[API](https://skmtc.net/synthesia/apis/synthesia-api.md) · [All operations](https://skmtc.net/synthesia/apis/synthesia-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/synthesia/synthesia-api/versions/f0f34ae0591d/schema)
