LIlingopal
videos

Upload Video

Changed on

Upload Video with File or URL

This endpoint allows you to upload a video for processing, and you can provide the following parameters:

  • name: Provide a unique name for the video.

  • languages: Specify a comma-separated list of locales, for example, "en-US,es-US,fr-FR".

  • burn_subtitles: You can choose to burn subtitles in the translated video.

  • burn_subtitles_on_source: You can choose to burn subtitles on the source video.

  • remove_background_audio: You can choose to remove the background audio from the video.

  • source_url: Provide a URL to the video file. Supported sources include direct video URLs, Vimeo, Google Drive, and presigned S3 URLs. YouTube URLs are not supported. Do not send source_url and file in the same request.

  • file: Upload the video file here. Do not send file and source_url in the same request.

  • subtitles_file_urls: If you have subtitles files for the video, provide the URLs here. When is_source_srt is false, the number of URLs should match the number of languages. When is_source_srt is true, exactly one URL is allowed and it will be treated as the source-language subtitles. A subtitle URL cannot be the same as source_url.

  • prepend_ai_warning: If you want to prepend an AI warning to the audio. Cannot be used with skip_translate.

  • skip_translate: If you want to skip the translation.

  • enhance_transcription: Enhance transcription when using the default pipeline with skip_translate.

  • context_for_translation: If you want to provide a context for the translation.

  • experimental_force_accent: If you want to force the accent for the translation.

If the file size exceeds 1GB, it's recommended to use the source_url option. Additionally, for larger files, you can utilize the uploads API to upload the video and obtain a generated source_url for use in this endpoint.

post/v1/videos/

Request

Request body multipart/form-data

namestring required
languagesstring nullable
remove_background_audioboolean
number_of_speakersinteger
burn_subtitlesboolean
burn_subtitles_on_sourceboolean
source_urlstring nullable
subtitles_file_urlsstring nullable
is_source_srtboolean
adjust_video_lengthboolean nullable
prepend_ai_warningboolean nullable
skip_translateboolean nullable
enhance_transcriptionboolean nullable
context_for_translationstring nullable
experimental_force_accentboolean nullable
use_ng_pipelineboolean nullable
clone_voiceboolean

Omitted or true: automatically select voice cloning per target language using voice_cloning_support from GET /v2/languages/dubbing, subject to account restrictions. False: use preset voices for all target languages.

word_count_per_lineinteger
filestring binary nullable

Response

Successful Response

messagestring required
warningstring nullable
idstring required
namestring required
created_onstring date-time nullable required

Changes

  • 4d38122815b2Revision changes
    • breaking

      request property list-of-types was narrowed by removing types null from media type multipart/form-data

    • warning

      added the new Cancelled enum value to the // response property for the response status

    • info

      the request property default value changed from false to true

    • info

      the request property default value changed from false to true

  • bfb32c0b28deRevision changes
    • warning

      removed the request property

    • info

      added the new optional request property