360 Secure SkillHub
360 安全技能中心

Speechmatics

通过 Speechmatics 异步批处理 API 转录音频：脚本提交任务、轮询状态并写入转录结果，支持 txt、json、srt 输出，可设置语言、运行点、说话人分离、超时与 API 基础地址，密钥来自命令行、环境变量或宿主配置。

coreyh
coreyh
热度 39.72
最近更新 2026-05-11 17:43:07
分类：效率依赖：代码执行 / 读写文件 / 第三方 API应用场景：文件转换 / API 集成

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add speechmatics
Metadata
name
speechmatics
description
Transcribe audio files (voice notes, recordings, podcasts) to text via the Speechmatics batch transcription API. Use when the user asks to transcribe audio, convert speech to text, or get a transcript of a recording, and Speechmatics is configured.
homepage
https://docs.speechmatics.com/introduction/batch-transcription
metadata
{"openclaw":{"emoji":"🗣️","requires":{"bins":["curl","jq"],"env":["SPEECHMATICS_API_KEY"]},"primaryEnv":"SPEECHMATICS_API_KEY","install":[{"id":"apt","kind":"apt","packages":["curl","jq"],"bins":["curl","jq"],"label":"Install curl and jq (apt)"},{"id":"brew","kind":"brew","formula":"jq","bins":["jq"],"label":"Install jq (brew)"}]}}

Speechmatics (batch transcription)

Transcribe an audio file via Speechmatics' async batch API. Submits a job, polls until complete, then writes the transcript.

Quick start

{baseDir}/scripts/transcribe.sh /path/to/audio.m4a

Defaults:

  • Language: en
  • Operating point: enhanced (better accuracy; use standard for faster/cheaper)
  • Output: <input>.txt in the same directory
  • Poll interval: 3s, timeout: 600s

Useful flags

{baseDir}/scripts/transcribe.sh /path/to/audio.ogg --language da
{baseDir}/scripts/transcribe.sh /path/to/meeting.wav --operating-point standard
{baseDir}/scripts/transcribe.sh /path/to/call.mp3 --diarization speaker
{baseDir}/scripts/transcribe.sh /path/to/audio.m4a --format json --out /tmp/transcript.json
{baseDir}/scripts/transcribe.sh /path/to/audio.m4a --format srt --out /tmp/subs.srt
{baseDir}/scripts/transcribe.sh /path/to/long.wav --timeout 1800

Formats: txt (default, plain text), json (Speechmatics json-v2 with word timings), srt (subtitles).

API key

The script reads the API key from (in order):

  1. --api-key <key> flag
  2. SPEECHMATICS_API_KEY environment variable (set by openclaw from the entry below)
  3. skills.entries.speechmatics.apiKey in $OPENCLAW_CONFIG_PATH (default ~/.openclaw/openclaw.json)

Configure via openclaw.json:

{
  skills: {
    entries: {
      speechmatics: {
        apiKey: "SPEECHMATICS_KEY_HERE",
      },
    },
  },
}

Override the API base (e.g. EU region or a proxy) with --base-url or SPEECHMATICS_BASE_URL. Default: https://asr.api.speechmatics.com/v2.

Notes

  • Supports most common audio formats (wav, mp3, m4a, ogg, flac, mp4, etc.) — Speechmatics transcodes server-side.
  • File size limit: 2 GB per job.
  • Batch jobs complete in roughly 1:10 wallclock to audio duration on enhanced; standard is faster.
  • Always confirm any destructive follow-up (e.g. replying based on a transcript) before acting.