Skip to content

Commit 718c082

Browse files
tsmith512dcpena
andauthored
[Stream] Expanded language support for automated captions (#19562)
* [Stream] Clarify delivery pricing mechanics * [Stream] Prep announcement for expanded language support for auto-captions * [Stream] Expanded Language Support * catastropostrophe * Update src/content/docs/stream/pricing.mdx grammar fix * fix link --------- Co-authored-by: Denise Peña <[email protected]>
1 parent 486552c commit 718c082

File tree

4 files changed

+51
-7
lines changed

4 files changed

+51
-7
lines changed
Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
---
2+
title: Expanded language support for Stream AI Generated Captions
3+
description: Captions can now be generated for 11 additional spoken languages at no cost!
4+
products:
5+
- stream
6+
date: 2025-01-30T12:00:00Z
7+
---
8+
9+
Stream's [generated captions](/stream/edit-videos/adding-captions/#generate-a-caption)
10+
leverage Workers AI to automatically transcribe audio and provide captions to
11+
the player experience. We have added support for these languages:
12+
13+
- `cs` - Czech
14+
- `nl` - Dutch
15+
- `fr` - French
16+
- `de` - German
17+
- `it` - Italian
18+
- `ja` - Japanese
19+
- `ko` - Korean
20+
- `pl` - Polish
21+
- `pt` - Portuguese
22+
- `ru` - Russian
23+
- `es` - Spanish
24+
25+
For more information, learn about [adding captions to videos](/stream/edit-videos/adding-captions/).

src/content/changelogs/stream.yaml

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,10 @@ productLink: "/stream/"
55
productArea: Developer platform
66
productAreaLink: /workers/platform/changelog/platform/
77
entries:
8+
- publish_date: "2025-01-30"
9+
title: Expanded Language Support for Generated Captions
10+
description: |-
11+
Eleven new languages are now supported for transcription when using [generated captions](/stream/edit-videos/adding-captions/#generate-a-caption), available for free for video stored in Stream.
812
- publish_date: "2024-08-15"
913
title: Full HD encoding for Portrait Videos
1014
description: |-

src/content/docs/stream/edit-videos/adding-captions.mdx

Lines changed: 21 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ caption file.
1515

1616
To create or modify a caption on a video a [Cloudflare API Token](https://www.cloudflare.com/a/account/my-account) is required.
1717

18-
The `<LANGUAGE_TAG>` must adhere to the [BCP 47 format](http://www.unicode.org/reports/tr35/#Unicode_Language_and_Locale_Identifiers). For convenience, the most common
18+
The `<LANGUAGE_TAG>` must adhere to the [BCP 47 format](http://www.unicode.org/reports/tr35/#Unicode_Language_and_Locale_Identifiers). For convenience, many common
1919
language codes are provided [at the bottom of this document](#most-common-language-codes).
2020
If the language you are adding isn't included in the table, you can find the value
2121
through the [The IANA registry](https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry), which maintains a list of language codes. To find the
@@ -45,19 +45,34 @@ Generated captions use artificial intelligence based speech-to-text technology
4545
to generate closed captions for your videos.
4646

4747
A video must be uploaded and in a ready state before captions can be generated.
48-
In the following example URLs, the videos UID is referenced as \<VIDEO\_UID>.
48+
In the following example URLs, the video's UID is referenced as `<VIDEO_UID>`.
4949
To receive webhooks when a video transitions to ready after upload, follow the
5050
instructions provided [here](/stream/manage-video-library/using-webhooks/).
5151

52-
Only English language caption generation is currently supported.
52+
Captions can be generated for the following languages:
5353

54-
Videos may include several language captions, but each language must be unique.
54+
- `cs` - Czech
55+
- `nl` - Dutch
56+
- `en` - English
57+
- `fr` - French
58+
- `de` - German
59+
- `it` - Italian
60+
- `ja` - Japanese
61+
- `ko` - Korean
62+
- `pl` - Polish
63+
- `pt` - Portuguese
64+
- `ru` - Russian
65+
- `es` - Spanish
66+
67+
When generating captions, generate them for the spoken language in the audio.
68+
69+
Videos may include captions for several languages, but each language must be unique.
5570
For example, a video may have English, French, and German captions associated
5671
with it, but it cannot have two English captions. If you have already uploaded
5772
an English language caption for a video, you must first delete it in order to
5873
create an English generated caption. Instructions on how to delete a caption can be found below.
5974

60-
The \<LANGUAGE\_TAG> must adhere to the BCP 47 format. The tag for English is `en`.
75+
The `<LANGUAGE_TAG>` must adhere to the BCP 47 format. The tag for English is `en`.
6176
You may specify a region in the tag, such as `en-GB`, which will render a label
6277
that shows `British English` for the caption.
6378

@@ -171,7 +186,7 @@ https://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/stream/<VIDEO_UID>/ca
171186

172187
### Example response to get the caption file for a video
173188

174-
```bash
189+
``` text
175190
WEBVTT
176191
177192
1

src/content/docs/stream/pricing.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,7 @@ Delivery is counted by HTTP requests for video segments or parts of the MP4. The
5555
- Content played from client-side/browser cache is not billable, like a short looping video. Some mobile app player libraries do not cache HLS segments by default.
5656
- MP4 Downloads are billed by percentage of the file delivered.
5757

58-
HLS and DASH playback is rounded to the segment length. For uploaded content, HLS and DASH segments are four seconds. Live broadcast segments are determined by the keyframe interval or GOP size.
58+
Minutes delivered for web playback (HLS and DASH) are rounded to the _segment_ length: for uploaded content, segments are four seconds. Live broadcast and recording segments are determined by the keyframe interval or GOP size of the original broadcast.
5959

6060
## Example scenarios
6161

0 commit comments

Comments
 (0)