Skip to content

Added a note about the maximum duration of realtime transcription sessions (3 hours)#105

Open
Karamouche wants to merge 1 commit intomainfrom
feat/realtime-limitation
Open

Added a note about the maximum duration of realtime transcription sessions (3 hours)#105
Karamouche wants to merge 1 commit intomainfrom
feat/realtime-limitation

Conversation

@Karamouche
Copy link
Contributor

@Karamouche Karamouche commented Feb 10, 2026

Summary by CodeRabbit

  • Documentation
    • Added specification for realtime session duration limit of 3 hours for live transcription sessions.
    • Clarified audio length limit terminology to distinguish between pre-recorded and realtime audio.
    • Added guidance on starting new sessions for events exceeding the 3-hour realtime limit.

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Feb 10, 2026

📝 Walkthrough

Walkthrough

Documentation updates establishing a 3-hour maximum duration limit for realtime transcription sessions. The constraint is documented across concurrency limits, supported formats, and live STT quickstart sections, with guidance for users to start new sessions for longer events.

Changes

Cohort / File(s) Summary
Realtime Session Duration Documentation
chapters/limits-and-specifications/concurrency.mdx, chapters/limits-and-specifications/supported-formats.mdx, chapters/live-stt/quickstart.mdx
Adds documentation of a 3-hour hard limit for realtime/transcription sessions across three files. Renamed "Audio length" to "Audio length (pre-recorded)" in supported-formats to distinguish pre-recorded from realtime constraints. Includes guidance to start new sessions for longer events.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Suggested reviewers

  • hpapier
  • nmorel

Poem

🐰 Three hours max for sessions that stream,
The rabbit documents this limit supreme,
Across the guides, so users all know,
When to start fresh and let new sessions flow! ⏰✨

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly and concisely summarizes the main change: adding documentation about a 3-hour maximum duration limit for realtime transcription sessions across multiple documentation files.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch feat/realtime-limitation

Tip

Issue Planner is now in beta. Read the docs and try it out! Share your feedback on Discord.


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 3

🤖 Fix all issues with AI agents
In `@chapters/limits-and-specifications/concurrency.mdx`:
- Around line 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.

In `@chapters/limits-and-specifications/supported-formats.mdx`:
- Around line 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.

In `@chapters/live-stt/quickstart.mdx`:
- Around line 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**."

Comment on lines +32 to +34
- **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.
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.

Comment on lines +26 to +27
- **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.

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.

Comment on lines +9 to +11
<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>
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**."

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant