---
title: "Generate Subtitles From Video"
method: POST
path: "/v1/subtitles/"
tags: ["subtitles"]
---

# Generate Subtitles From Video

`POST /v1/subtitles/`

Upload video to generate subtitles:

- **name**: Provide a name for the subtitles. Default is name of the media.
- **file**: Upload the video file here. **Required** when using API.
- **languages**: Provide a comma-separated list of locales, for example, "**en-US,es-US,fr-FR**"
- **word_count_per_line**: Provide the word count per line for the subtitles. Default is 7.

## 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)