ASR

Transcribe audio files into text using the z-ai-web-dev-sdk speech recognition API.

Updated Jul 11, 2026
One-click install
npx skills add https://github.com/mukaddam-ali/Anadolu-Kitchen --skill asr-mukaddam-ali
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ASR
Source: https://github.com/mukaddam-ali/Anadolu-Kitchen/tree/main/skills/ASR
Command: npx skills add https://github.com/mukaddam-ali/Anadolu-Kitchen --skill asr-mukaddam-ali

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires z-ai-web-dev-sdk, and includes scripts (resource) components.

What problem does it solve? Converting spoken audio into written text manually is slow and error-prone. This Skill implements automatic speech recognition so you can transcribe WAV, MP3, and other audio files programmatically in backend Node.js applications. ## Core Features & Use Cases - Audio Transcription: Convert base64-encoded audio files into accurate text via the z-ai-web-dev-sdk ASR API. - Batch & Directory Processing: Transcribe multiple recordings at once with per-file error handling and JSON result export. - CLI Support: Run quick one-off transcriptions with the z-ai CLI without writing code. - Use Case: Build an Express.js endpoint that accepts uploaded meeting recordings and returns searchable text transcriptions with word counts. ## Quick Start Ask the AI to transcribe the audio file meeting.wav into text using the ASR skill.

Frequently Asked Questions about ASR

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

FAQPage Schema
How do I transcribe an audio file to text in Node.js?

Read the audio file with fs, convert it to a base64 string, and pass it to zai.audio.asr.create from the z-ai-web-dev-sdk. The response text field contains the transcription. The SDK must only run in backend code.

What audio formats does speech-to-text transcription support?

The ASR service supports WAV, MP3, M4A, FLAC, and OGG formats. For best accuracy, use a sample rate of 16kHz or higher with clear speech and minimal background noise.

Can I use z-ai-web-dev-sdk in client-side browser code?

No, the z-ai-web-dev-sdk must be used in backend code only. Importing it in client-side code will fail, so transcription logic should live in server-side routes or services such as an Express.js endpoint.

Why does audio transcription return empty or incorrect text?

Empty results usually come from poor audio quality, unsupported formats, or unclear speech. Verify the file format is supported, reduce background noise, and check that the audio contains audible spoken content.

How do I handle large audio files during transcription?

Files over roughly 100MB should be split into smaller segments before transcription. You can also cache results by hashing the audio buffer to avoid reprocessing duplicate files and reduce memory pressure.