projects

Create a translated video or audio project

Create a project from your uploaded fileKey, transcribe and translate it, then synthesize its speech. Supports caller SRT, voices, subtitles and optional lip sync. Uses the normal media credits. An optional webhookUrl receives processing events. Poll projects_status.

post/actions/translations_create

Request

  • Base URL: https://api.voicecheap.ai/v1
  • URL: https://api.voicecheap.ai/v1/actions/translations_create
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Headers

Idempotency-Keystring uuid

UUID v4 shared across retries of this action. Alternatively pass requestId in the JSON body.

Request body

fileKeystring required
targetLanguage'afrikaans' | 'albanian' | 'amharic' | 'arabic' | 'armenian' | 'assamese' | 'azerbaijani' | 'basque' | 'belarusian' | 'bengali' | 'bosnian' | 'bulgarian' | 'catalan' | 'croatian' | 'czech' | 'danish' | 'dutch' | 'english' | 'british english' | 'estonian' | 'finnish' | 'french' | 'french canadian' | 'galician' | 'german' | 'greek' | 'gujarati' | 'hebrew' | 'hindi' | 'hungarian' | 'icelandic' | 'indonesian' | 'irish' | 'italian' | 'japanese' | 'kannada' | 'kazakh' | 'khmer' | 'korean' | 'lao' | 'latvian' | 'lithuanian' | 'macedonian' | 'malay' | 'malayalam' | 'mandarin' | 'marathi' | 'mongolian' | 'nepali' | 'norwegian' | 'persian' | 'polish' | 'portuguese' | 'brazilian portuguese' | 'pt_brazil' | 'punjabi' | 'romanian' | 'russian' | 'serbian' | 'slovak' | 'slovenian' | 'spanish' | 'swahili' | 'swedish' | 'tagalog' | 'tamil' | 'telugu' | 'thai' | 'turkish' | 'ukrainian' | 'urdu' | 'vietnamese' | 'welsh' | 'yoruba' | 'zulu' required
originalLanguage'af' | 'sq' | 'am' | 'ar' | 'hy' | 'as' | 'ast' | 'az' | 'ba' | 'eu' | 'be' | 'bn' | 'bs' | 'br' | 'bg' | 'my' | 'ca' | 'ceb' | 'zh' | 'hr' | 'cs' | 'da' | 'nl' | 'en' | 'eo' | 'at' | 'et' | 'fil' | 'fo' | 'fi' | 'fr' | 'fr-CA' | 'fy' | 'ff' | 'gd' | 'gl' | 'lg' | 'ka' | 'de' | 'el' | 'gu' | 'ht' | 'ha' | 'haw' | 'he' | 'hi' | 'hu' | 'is' | 'ig' | 'ilo' | 'id' | 'ia' | 'ga' | 'it' | 'ja' | 'jv' | 'kea' | 'kn' | 'kk' | 'km' | 'kur' | 'kir' | 'ko' | 'lo' | 'la' | 'luo' | 'lv' | 'lb' | 'ln' | 'lt' | 'mk' | 'mg' | 'ms' | 'ml' | 'mt' | 'mi' | 'mr' | 'mo' | 'mn' | 'ne' | 'no' | 'nn' | 'nso' | 'nya' | 'oc' | 'or' | 'pa' | 'ps' | 'fa' | 'pl' | 'pt' | 'ro' | 'ru' | 'sa' | 'sr' | 'sn' | 'sd' | 'si' | 'sk' | 'sl' | 'so' | 'es' | 'su' | 'sw' | 'ss' | 'sv' | 'tl' | 'tg' | 'ta' | 'tt' | 'te' | 'th' | 'bo' | 'tn' | 'tr' | 'tk' | 'ug' | 'uk' | 'umb' | 'ur' | 'uz' | 'vi' | 'cy' | 'wo' | 'xh' | 'yi' | 'yo' | 'zu' | 'cmn' | 'yue' | 'en-GB' | 'en-US' | 'en-AU' | 'auto-detect'
projectNamestring
numberOfSpeakers'1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' | '10' | '11' | '12' | '13' | '14' | '15' | '16' | '17' | '18' | '19' | '20' | '21' | '22' | '23' | '24' | '25' | '26' | '27' | '28' | '29' | '30' | '31' | '32' | 'auto-detect'
brandVocabularystring[]
removeFillerWordsboolean
sourceSrtstring
webhookUrlstring uri
requestIdstring uuid

UUID v4 for this action. Reuse the same ID with identical arguments on retries.

keepBackgroundMusicboolean
keepOriginalVoiceboolean
originalVoiceVolumenumber
voiceMode'cloning' | 'custom'
voiceIdstring
subtitlesboolean
subtitlesSource'translated' | 'original'
voiceIsolatorOption'studio' | 'realistic'
lipSyncMode'standard' | 'pro' | 'studio'
activeSpeakerDetectionEnabledboolean
translatedSrtstring

Response

Completed result or saved request state.

dataunknown required
requestIdstring uuid

Changes

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