Quick Links

1. concepts/auth-and-processing-modes.md
2. scenarios/high-level-scenarios.md
3. examples/fast-mode-node.md
4. examples/batch-webhook-pipeline.md
5. references/api-reference.md
6. references/environment-variables.md
7. references/samples-validation.md
8. references/versioning-and-drift.md
9. troubleshooting/common-drift-and-breaks.md
10. RUNBOOK.md

Core Workflow

1. Get Build-platform credentials and generate an HS256 JWT.
2. Choose fast mode for one short file or batch mode for stored archives / large sets.
3. Submit the transcription request.
4. For batch jobs, poll job/file status or receive webhook notifications.
5. Persist and post-process transcript JSON.

Hosted Fast-Mode Guardrail

• The formal fast-mode API limits are 100 MB and 2 hours, but hosted browser flows can still time out before the upstream response returns.
• Current deployed-sample observations:
  • ~17.2 MB MP4 completed in about 26s
  • ~38.6 MB MP4 completed in about 26-37s
  • ~59.2 MB MP4 completed in about 32-34s on the backend
  • some ~59.2 MB browser requests still surfaced as frontend 504 while backend logs later showed 200
• Treat frontend 504 plus backend 200 as a browser/edge timeout race, not an automatic transcription failure.
• For hosted UIs, prefer an async request/polling wrapper for fast mode instead of holding the browser open for the full upstream response.
• For larger or less predictable media, prefer batch mode even when the file is still within the formal fast-mode size limit.

Browser Microphone Pattern

• scribe does not expose a documented real-time streaming API surface.
• If you want a browser microphone experience, use pseudo-streaming:
  1. capture microphone audio in short chunks
  2. upload each chunk through the async fast-mode wrapper
  3. poll for completion
  4. append chunk transcripts in sequence
• Recommended starting cadence:
  • chunk size: 5 seconds
  • acceptable range: 5-10 seconds
  • in-flight chunk requests: 2-3
• This is a practical UI pattern for incremental transcript updates, not a substitute for rtms.
• Treat this as a fallback demo pattern, not the preferred production architecture.
• It adds repeated upload overhead, chunk-boundary drift, browser codec/container variability, and transcript stitching complexity.

…

variance-analysis

拆解财务差异成因，生成瀑布分析与管理层解读说明。

happy-scribe-automation

通过 Rube MCP 自动化 Happy Scribe 的转录、字幕与相关工作流处理。