---
title: "Transcribe video"
method: POST
path: "/library/{libraryId}/videos/{videoId}/transcribe"
tags: ["Manage Videos"]
---

# Transcribe video

`POST /library/{libraryId}/videos/{videoId}/transcribe`

## Request

- Base URL: `https://video.bunnycdn.com`
- URL: `https://video.bunnycdn.com/library/{libraryId}/videos/{videoId}/transcribe`
- Auth: API key in header `AccessKey`
- TypeScript: <https://skmtc.dev/bunny/apis/stream-api/docs/library/:libraryId/videos/:videoId/transcribe/post.ts> (a function with typed inputs; its response is checked against the schema)

Queues transcription for the video, generating captions. By default this is blocked if the video was already auto-transcribed; set force to true to re-queue (and re-bill) transcription anyway.

## Path parameters

- `libraryId` integer, required
- `videoId` string, required

## Query parameters

- `force` boolean

## Request body

- TranscribeSettings
  - `targetLanguages` string[], nullable: List of languages that will be used as target languages, use ISO 639-1 language codes.
  - `generateTitle` boolean, nullable: Whether video title should be automatically generated.
  - `generateDescription` boolean, nullable: Whether video description should be automatically generated.
  - `generateChapters` boolean, nullable: Whether video chapters should be automatically generated.
  - `generateMoments` boolean, nullable: Whether video moments should be automatically generated.
  - `sourceLanguage` string, nullable: Video source language, use ISO 639-1 language code.

## Response `200`

The transcription was queued

- StatusModel
  - `success` boolean: Determines if the request was successful
  - `message` string, nullable: Human-readable message describing the result, typically populated with error details when Success is false.
  - `statusCode` integer: The HTTP status code corresponding to the result of the request.

## Other responses

- `400`: Invalid request for transcription queue
- `401`: The request authentication failed
- `403`: The request authorization failed
- `404`: The requested video was not found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/bunny/apis/stream-api.md) - [All operations](https://skmtc.dev/bunny/apis/stream-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bunny/apis/stream-api/revisions/83116184952f?raw)