---
title: "Upload Video"
method: POST
path: "/v1/videos/"
tags: ["videos"]
---

# Upload Video

`POST /v1/videos/`

**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.

- **file**: Upload the video file here. Please note that this will take precedence over the source URL.

- **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.

- **prepend_ai_warning**:  If you want to prepend an AI warning to the audio.

- **skip_translate**: If you want to skip the translation.

- **enhance**: <ins>**Required for multi-language**</ins><br/> If you want to enhance the translation.

- **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](https://api.lingopal.ai/#/uploads/upload_files_v1_uploads__get) to upload the video and obtain a generated source_url for use in this endpoint.

## Response `201`

Successful Response

- MediaTranslationResponse
  - `metadata` MediaMetadata
    - `duration` number, required
  - `message` string, required
  - `id` string, required
  - `name` string, required
  - `created_on` string, date-time, nullable, required
  - `languages` TranslationLanguage[], required
    - `status` 'Completed' | 'Processing' | 'Failed' | 'Pending', required
    - `language` LanguageInfo, required
      - `locale` string, required
      - `language` string, required

## Other responses

- `422` — Validation Error

---

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