Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions chapters/limits-and-specifications/concurrency.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
description: "Rate limiting and transcriptions concurrency"
---

In order to provide a smooth experience and optimal performance for all users, Gladia accounts can have up to **3** differents limits

Check warning on line 6 in chapters/limits-and-specifications/concurrency.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gladia-95) - vale-spellcheck

chapters/limits-and-specifications/concurrency.mdx#L6

Did you really mean 'Gladia'?

Check warning on line 6 in chapters/limits-and-specifications/concurrency.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gladia-95) - vale-spellcheck

chapters/limits-and-specifications/concurrency.mdx#L6

Did you really mean 'differents'?
for **Free**, **Paid** & **Enterprise** users :

<Note>
Expand All @@ -29,6 +29,10 @@
This refers to the maximum number of transcription (pre-recorder or real-time) that a user can process at the same time.
For asynchronous transcriptions, Paid plan users can queue up to 300 requests, but only will still have 25 max processed concurrently.

- **Realtime session duration** : (all plans)

Check warning on line 32 in chapters/limits-and-specifications/concurrency.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gladia-95) - vale-spellcheck

chapters/limits-and-specifications/concurrency.mdx#L32

Did you really mean 'Realtime'?

A single realtime (live) transcription session cannot exceed **3 hours**. After 3 hours, the session will be terminated. For longer events, start a new session when approaching the limit.

Check warning on line 34 in chapters/limits-and-specifications/concurrency.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gladia-95) - vale-spellcheck

chapters/limits-and-specifications/concurrency.mdx#L34

Did you really mean 'realtime'?
Comment on lines +32 to +34
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Inconsistent terminology: "realtime" vs. "real-time".

The rest of this document (line 29) and the quickstart page title (line 3 of quickstart.mdx) use the hyphenated form "real-time," but lines 32 and 34 introduce "Realtime" / "realtime." The vale spellcheck also flags this. Consider using "Real-time" consistently to match the existing docs.

Also, a minor wording inconsistency: this file says "when approaching the limit" while the other two files say "before reaching the limit." Aligning the phrasing across all three pages would reduce reader confusion.

Suggested fix
-- **Realtime session duration** : (all plans)
+- **Real-time session duration** : (all plans)
 
-  A single realtime (live) transcription session cannot exceed **3 hours**. After 3 hours, the session will be terminated. For longer events, start a new session when approaching the limit.
+  A single real-time (live) transcription session cannot exceed **3 hours**. After 3 hours, the session will be terminated. For longer events, start a new session before reaching the limit.
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
- **Realtime session duration** : (all plans)
A single realtime (live) transcription session cannot exceed **3 hours**. After 3 hours, the session will be terminated. For longer events, start a new session when approaching the limit.
- **Real-time session duration** : (all plans)
A single real-time (live) transcription session cannot exceed **3 hours**. After 3 hours, the session will be terminated. For longer events, start a new session before reaching the limit.
🧰 Tools
🪛 GitHub Check: Mintlify Validation (gladia-95) - vale-spellcheck

[warning] 32-32: chapters/limits-and-specifications/concurrency.mdx#L32
Did you really mean 'Realtime'?


[warning] 34-34: chapters/limits-and-specifications/concurrency.mdx#L34
Did you really mean 'realtime'?

🤖 Prompt for AI Agents
In `@chapters/limits-and-specifications/concurrency.mdx` around lines 32 - 34,
Replace the inconsistent "Realtime"/"realtime" heading and occurrences with the
hyphenated form "Real-time" (e.g., change the heading "Realtime session
duration" to "Real-time session duration" and any inline "realtime" to
"real-time") and standardize the sentence ending by replacing "when approaching
the limit" with the phrasing used elsewhere ("before reaching the limit") so the
block under the Real-time session duration heading matches the terminology and
wording in the rest of the docs.


- **API level rate limit** : (same for every user)

Which is the number of API calls that a user can make within a particular time frame.
Expand Down
4 changes: 3 additions & 1 deletion chapters/limits-and-specifications/supported-formats.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,26 +3,28 @@
description: "Media files limitations"
---

We support almost all types of audio or video files with a tradeoff to be taken into account between the transfer time of specific formats that can generate big files and the time to convert the original format to the target one (WAV pcm 16KHz little-endian).

Check warning on line 6 in chapters/limits-and-specifications/supported-formats.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gladia-95) - vale-spellcheck

chapters/limits-and-specifications/supported-formats.mdx#L6

Did you really mean 'pcm'?

You can find an estimate of the conversion times in the table below.


## Gladia API current limitations

Check warning on line 11 in chapters/limits-and-specifications/supported-formats.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gladia-95) - vale-spellcheck

chapters/limits-and-specifications/supported-formats.mdx#L11

Did you really mean 'Gladia'?

<Tip>
Those limits will be gradually lifted to ensure the full stability and performance of the service for everyone.
</Tip>


- **Audio length**: The maximum length of audio that can be transcribed in a single request is currently
- **Audio length (pre-recorded)**: The maximum length of audio that can be transcribed in a single request is currently
135 minutes. Attempts to transcribe longer audio files will result in an error.
Direct YouTube links are limited to 120 minutes instead of 135 minutes.

<Tip>
We support up to 4h15 audio length for enterprise plans.
</Tip>

- **Realtime session duration**: For [live (realtime) transcription](/chapters/live-stt/quickstart), a single WebSocket session cannot exceed **3 hours**. The session will be terminated after 3 hours; for longer events, start a new session before reaching the limit.

Check warning on line 26 in chapters/limits-and-specifications/supported-formats.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gladia-95) - vale-spellcheck

chapters/limits-and-specifications/supported-formats.mdx#L26

Did you really mean 'Realtime'?

Comment on lines +26 to +27
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Same terminology nit: "Realtime" → "Real-time".

Same issue as in concurrency.mdx — use "Real-time" to stay consistent with the rest of the docs and silence the vale spellcheck warning.

Suggested fix
-- **Realtime session duration**: For [live (realtime) transcription](/chapters/live-stt/quickstart), a single WebSocket session cannot exceed **3 hours**. The session will be terminated after 3 hours; for longer events, start a new session before reaching the limit.
+- **Real-time session duration**: For [live (real-time) transcription](/chapters/live-stt/quickstart), a single WebSocket session cannot exceed **3 hours**. The session will be terminated after 3 hours; for longer events, start a new session before reaching the limit.
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
- **Realtime session duration**: For [live (realtime) transcription](/chapters/live-stt/quickstart), a single WebSocket session cannot exceed **3 hours**. The session will be terminated after 3 hours; for longer events, start a new session before reaching the limit.
- **Real-time session duration**: For [live (real-time) transcription](/chapters/live-stt/quickstart), a single WebSocket session cannot exceed **3 hours**. The session will be terminated after 3 hours; for longer events, start a new session before reaching the limit.
🧰 Tools
🪛 GitHub Check: Mintlify Validation (gladia-95) - vale-spellcheck

[warning] 26-26: chapters/limits-and-specifications/supported-formats.mdx#L26
Did you really mean 'Realtime'?

🤖 Prompt for AI Agents
In `@chapters/limits-and-specifications/supported-formats.mdx` around lines 26 -
27, Replace the inconsistent term "Realtime" with "Real-time" in the sentence
that begins "Realtime session duration" (the bullet describing the live
(realtime) transcription WebSocket session 3-hour limit); update both the
displayed text and the parenthetical "realtime" to "real-time" so the phrase
reads "Real-time session duration" and "(live (real-time) transcription)" to
match the project's terminology and silence the spellcheck warning.

- **File size**: Audio files must not exceed 1000 MB in size. Larger files will not be accepted by the API.

### Splitting oversize audio files
Expand All @@ -31,7 +33,7 @@
Tools for Splitting Audio Files:

- **FFMPEG** : FFMPEG is a versatile command-line tool that can be used to manipulate audio and video files. It is a popular choice for splitting long audio files.
- **ffmpeg-python** : For Python users, ffmpeg-python is a wrapper around FFMPEG that provides a more Pythonic interface for interacting with FFMPEG.

Check warning on line 36 in chapters/limits-and-specifications/supported-formats.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gladia-95) - vale-spellcheck

chapters/limits-and-specifications/supported-formats.mdx#L36

Did you really mean 'Pythonic'?
- **prism-media** for Node.js : Node.js users can use prism-media for manipulating media files, including splitting audio files.
- **fluent-ffmpeg** for Node.js : Another option for Node.js users is fluent-ffmpeg, which offers a simpler and more fluent API for handling media files.

Expand All @@ -41,16 +43,16 @@

| Source Format | Mime Type | Audio/Video |
|---------------|----------------|-------------|
| aac | audio/aac | Audio |

Check warning on line 46 in chapters/limits-and-specifications/supported-formats.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gladia-95) - vale-spellcheck

chapters/limits-and-specifications/supported-formats.mdx#L46

Did you really mean 'aac'?
| ac3 | audio/ac3 | Audio |
| eac3 | audio/eac3 | Audio |
| flac | audio/flac | Audio |

Check warning on line 49 in chapters/limits-and-specifications/supported-formats.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gladia-95) - vale-spellcheck

chapters/limits-and-specifications/supported-formats.mdx#L49

Did you really mean 'flac'?
| m4a | audio/mp4 | Audio |
| mp2 | audio/mpeg | Audio |
| mp3 | audio/mpeg | Audio |
| ogg | application/ogg| Audio |

Check warning on line 53 in chapters/limits-and-specifications/supported-formats.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gladia-95) - vale-spellcheck

chapters/limits-and-specifications/supported-formats.mdx#L53

Did you really mean 'ogg'?
| opus | audio/opus | Audio |
| wav | audio/wav | Audio |

Check warning on line 55 in chapters/limits-and-specifications/supported-formats.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gladia-95) - vale-spellcheck

chapters/limits-and-specifications/supported-formats.mdx#L55

Did you really mean 'wav'?


## Supported video formats
Expand All @@ -59,13 +61,13 @@
|---------------|----------------------|-------------|
| 3g2 | video/3gpp2 | Video |
| 3gp | video/3gpp | Video |
| avi | video/x-msvideo | Video |

Check warning on line 64 in chapters/limits-and-specifications/supported-formats.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gladia-95) - vale-spellcheck

chapters/limits-and-specifications/supported-formats.mdx#L64

Did you really mean 'avi'?
| flv | video/x-flv | Video |

Check warning on line 65 in chapters/limits-and-specifications/supported-formats.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gladia-95) - vale-spellcheck

chapters/limits-and-specifications/supported-formats.mdx#L65

Did you really mean 'flv'?
| m4v | video/x-m4v | Video |
| matroska | video/x-matroska | Audio/Video |

Check warning on line 67 in chapters/limits-and-specifications/supported-formats.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gladia-95) - vale-spellcheck

chapters/limits-and-specifications/supported-formats.mdx#L67

Did you really mean 'matroska'?
| mov | video/quicktime | Video |

Check warning on line 68 in chapters/limits-and-specifications/supported-formats.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gladia-95) - vale-spellcheck

chapters/limits-and-specifications/supported-formats.mdx#L68

Did you really mean 'mov'?
| mp4 | video/mp4 | Audio/Video |
| wmv | video/x-ms-wmv | Video |

Check warning on line 70 in chapters/limits-and-specifications/supported-formats.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gladia-95) - vale-spellcheck

chapters/limits-and-specifications/supported-formats.mdx#L70

Did you really mean 'wmv'?


## Supported online video services
Expand All @@ -77,10 +79,10 @@
| Instagram | Video | Released |
| Facebook | Video | Released |
| Vimeo | Video | Released |
| Dailymotion | Video | Released |

Check warning on line 82 in chapters/limits-and-specifications/supported-formats.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gladia-95) - vale-spellcheck

chapters/limits-and-specifications/supported-formats.mdx#L82

Did you really mean 'Dailymotion'?
| LinkedIn | Video | Released |
| Sharechat | Video | Released |

Check warning on line 84 in chapters/limits-and-specifications/supported-formats.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gladia-95) - vale-spellcheck

chapters/limits-and-specifications/supported-formats.mdx#L84

Did you really mean 'Sharechat'?
| Likee | Video | Released |

Check warning on line 85 in chapters/limits-and-specifications/supported-formats.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gladia-95) - vale-spellcheck

chapters/limits-and-specifications/supported-formats.mdx#L85

Did you really mean 'Likee'?
| TikTok (Beta) | Video | Beta |
| Twitter (Beta) | Video | Beta |

Expand All @@ -91,21 +93,21 @@
|---------------|------------------|-------------|------------------------------|------------------------------------|
| 3g2 | video/3gpp2 | Video | ~300 MB | ~30 seconds |
| 3gp | video/3gpp | Video | ~300 MB | ~40 seconds |
| aac | audio/aac | Audio | ~60 MB | ~36 seconds |

Check warning on line 96 in chapters/limits-and-specifications/supported-formats.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gladia-95) - vale-spellcheck

chapters/limits-and-specifications/supported-formats.mdx#L96

Did you really mean 'aac'?
| ac3 | audio/ac3 | Audio | ~215 MB | ~42 seconds |
| avi | video/x-msvideo | Video | ~800 MB | ~1 minute |

Check warning on line 98 in chapters/limits-and-specifications/supported-formats.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gladia-95) - vale-spellcheck

chapters/limits-and-specifications/supported-formats.mdx#L98

Did you really mean 'avi'?
| eac3 | audio/eac3 | Audio | ~215 MB | ~32 seconds |
| flac | audio/flac | Audio | ~260 MB | ~46 seconds |

Check warning on line 100 in chapters/limits-and-specifications/supported-formats.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gladia-95) - vale-spellcheck

chapters/limits-and-specifications/supported-formats.mdx#L100

Did you really mean 'flac'?
| flv | video/x-flv | Video | ~400 MB | ~40 seconds |

Check warning on line 101 in chapters/limits-and-specifications/supported-formats.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gladia-95) - vale-spellcheck

chapters/limits-and-specifications/supported-formats.mdx#L101

Did you really mean 'flv'?
| m4a | audio/m4a | Audio | ~60 MB | ~26 seconds |
| x-m4a | audio/x-m4a | Audio | ~60 MB | ~26 seconds |
| m4v | video/x-m4v | Video | ~800 MB | ~1 minute |
| matroska | video/x-matroska | Audio/Video | ~800 MB | ~1 minute |

Check warning on line 105 in chapters/limits-and-specifications/supported-formats.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gladia-95) - vale-spellcheck

chapters/limits-and-specifications/supported-formats.mdx#L105

Did you really mean 'matroska'?
| mov | video/quicktime | Video | ~800 MB | ~1 minute |

Check warning on line 106 in chapters/limits-and-specifications/supported-formats.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gladia-95) - vale-spellcheck

chapters/limits-and-specifications/supported-formats.mdx#L106

Did you really mean 'mov'?
| mp2 | audio/mpeg | Audio | ~120 MB | ~42 seconds |
| mp3 | audio/mpeg | Audio | ~120 MB | ~37 seconds |
| mp4 | video/mp4 | Audio/Video | ~800 MB | ~1 minute |
| ogg | application/ogg | Audio | ~60 MB | ~1 minute |

Check warning on line 110 in chapters/limits-and-specifications/supported-formats.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gladia-95) - vale-spellcheck

chapters/limits-and-specifications/supported-formats.mdx#L110

Did you really mean 'ogg'?
| opus | audio/opus | Audio | ~30 MB | ~1 minute |
| wav | audio/wav | Audio | ~510 MB | N/A |

Check warning on line 112 in chapters/limits-and-specifications/supported-formats.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gladia-95) - vale-spellcheck

chapters/limits-and-specifications/supported-formats.mdx#L112

Did you really mean 'wav'?
| wmv | video/x-ms-wmv | Video | ~800 MB | ~1 minute |

Check warning on line 113 in chapters/limits-and-specifications/supported-formats.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gladia-95) - vale-spellcheck

chapters/limits-and-specifications/supported-formats.mdx#L113

Did you really mean 'wmv'?
4 changes: 4 additions & 0 deletions chapters/live-stt/quickstart.mdx
Original file line number Diff line number Diff line change
@@ -1,11 +1,15 @@
---
title: Quickstart
description: How to transcribe live audio with Gladia's Real-time speech-to-text (STT) API

Check warning on line 3 in chapters/live-stt/quickstart.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gladia-95) - vale-spellcheck

chapters/live-stt/quickstart.mdx#L3

Did you really mean 'Gladia's'?
---

import LiveFlowFull from "/snippets/live-flow-full.mdx";
import Samples from '/snippets/samples.mdx';

<Note>
A single realtime transcription session cannot exceed **3 hours**. For longer events, start a new session before reaching the limit. See [Concurrency and rate limits](/chapters/limits-and-specifications/concurrency) and [Supported files & duration](/chapters/limits-and-specifications/supported-formats) for details.
</Note>
Comment on lines +9 to +11
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Good placement and cross-referencing.

The note is well-positioned at the top of the quickstart for high visibility, and the links to the limits pages are helpful.

One nit for consistency: line 3 of this very file says "Real-time speech-to-text" but line 10 uses "realtime." Prefer the hyphenated form here as well.

Suggested fix
 <Note>
-A single realtime transcription session cannot exceed **3 hours**. For longer events, start a new session before reaching the limit. See [Concurrency and rate limits](/chapters/limits-and-specifications/concurrency) and [Supported files & duration](/chapters/limits-and-specifications/supported-formats) for details.
+A single real-time transcription session cannot exceed **3 hours**. For longer events, start a new session before reaching the limit. See [Concurrency and rate limits](/chapters/limits-and-specifications/concurrency) and [Supported files & duration](/chapters/limits-and-specifications/supported-formats) for details.
 </Note>
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
<Note>
A single realtime transcription session cannot exceed **3 hours**. For longer events, start a new session before reaching the limit. See [Concurrency and rate limits](/chapters/limits-and-specifications/concurrency) and [Supported files & duration](/chapters/limits-and-specifications/supported-formats) for details.
</Note>
<Note>
A single real-time transcription session cannot exceed **3 hours**. For longer events, start a new session before reaching the limit. See [Concurrency and rate limits](/chapters/limits-and-specifications/concurrency) and [Supported files & duration](/chapters/limits-and-specifications/supported-formats) for details.
</Note>
🤖 Prompt for AI Agents
In `@chapters/live-stt/quickstart.mdx` around lines 9 - 11, Update the Note text
to use the hyphenated form "real-time" for consistency with the rest of the
document: locate the Note block containing the sentence starting "A single
realtime transcription session cannot exceed **3 hours**." and change "realtime"
to "real-time" so the sentence reads "A single real-time transcription session
cannot exceed **3 hours**."


<LiveFlowFull />
<Tip>
Want to know more about a specific feature? Check out our [Features chapter](/chapters/live-stt/features) for more details.
Expand Down