用途:该技能指导使用 z-ai-web-dev-sdk 实现语音转文字(ASR),把音频中的语音转换为文本,可用于语音控制界面、转写服务与音频内容分析。技能位于项目 {project_path}/skills/ASR,参考脚本见 {Skill Location}/scripts/asr.ts。
主要能力:支持从音频文件或 Base64 音频转写,支持流式输出,支持 WAV、MP3 等常见格式;可批量处理多个文件、按目录转写并输出 JSON,也可结合缓存、元数据与后处理(去空白、去填充词)使用。
使用方式:CLI 适合快速任务,例如 z-ai asr --file ./audio.wav、z-ai asr -f ./recording.mp3 -o transcript.json、z-ai asr --base64 "..." -o result.json、z-ai asr -f ./audio.wav --stream。SDK 适合应用集成:先 ZAI.create(),读取音频并转为 base64,再调用 zai.audio.asr.create({ file_base64: base64Audio }),返回 response.text。
适用场景:会议转写、访谈处理、播客转写、语音备忘、呼叫中心分析、无障碍文本替代、语音命令、语言学习等。
限制:z-ai-web-dev-sdk 只能在后端代码中使用,禁止用于客户端;音频需先转 base64;建议采样率 16kHz 以上、单文件不超过 100MB,大文件可分段处理;音频质量与噪声会影响识别准确率。资料未提供收费、价格与具体平台支持信息。