azure-speech-to-text

Transcribe audio files to text with word-level timestamps using Azure Fast Transcription API.

Updated Sep 1, 2026
One-click install
npx skills add https://github.com/zamansepeti43/c-rak-agent --skill azure-speech-to-text-zamansepeti43
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: azure-speech-to-text
Source: https://github.com/zamansepeti43/c-rak-agent/tree/main/video-engine/.agents/skills/azure-speech-to-text
Command: npx skills add https://github.com/zamansepeti43/c-rak-agent --skill azure-speech-to-text-zamansepeti43

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests.

What problem does it solve? Converting spoken audio into accurate, timestamped text for subtitles, transcripts, and video pipelines typically requires either slow local models or complex cloud batch jobs. This Skill provides synchronous cloud transcription of local audio files through Azure AI Speech, without Blob storage or native SDK setup. ## Core Features & Use Cases - Fast Transcription API: Synchronous multipart upload of local audio files returning word-level timestamps, phrase confidence, and detected language. - Speaker Diarization & Language ID: Optional speaker labels with configurable max speakers, plus automatic language identification across candidate locales. - Drop-in Schema Compatibility: Output matches the local faster-whisper transcriber schema, so it feeds directly into subtitle generation and downstream transcript consumers. - Use Case: Transcribe a narration MP3 for a video project, then pass the resulting segments and word timestamps to subtitle generation to produce accurately timed cues. ## Quick Start Set AZURE_SPEECH_KEY and AZURE_SPEECH_REGION, then ask the agent to transcribe your audio file with azure_stt and save the segments to your project's artifacts directory.

Frequently Asked Questions about azure-speech-to-text

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I transcribe audio to text with Azure Speech?

Set AZURE_SPEECH_KEY and AZURE_SPEECH_REGION, then call the azure_stt tool with your audio file path. It uploads the file via multipart POST to the Fast Transcription endpoint and returns segments with word-level timestamps.

Azure Fast Transcription vs Batch Transcription for audio files?

Fast Transcription handles local files synchronously with sub-real-time latency and no Blob storage. Batch Transcription requires audio hosted at a URL with SAS tokens and async job polling, suiting bulk or very long jobs.

Does Azure speech-to-text support speaker diarization?

Yes, enable the diarize parameter and set max_speakers to the expected upper bound. Azure returns speaker labels per phrase without requiring a HuggingFace token, unlike some local diarization setups.

What are the file size limits for Azure Fast Transcription?

A single request handles up to roughly two hours of audio or a few hundred MB. For longer recordings or bulk processing, use Azure Batch Transcription instead of the synchronous Fast Transcription endpoint.

What happens if Azure Speech is unavailable or not configured?

Fall back to the local transcriber tool running faster-whisper, which works fully offline. Its execute signature and output schema are identical, so downstream stages like subtitle generation work unchanged.