360 Secure SkillHub
360 安全技能中心

Audio Transcription

接收音频文件路径和可选语言代码,依次尝试本地 whisper、本地 whisper.cpp 或 OpenAI 转写接口输出纯文本;OGG 等格式可经 ffmpeg 自动转换,支持多语言与自动检测。

clediomir
clediomir
热度 28.01
最近更新 2026-05-17 12:46:00
分类:效率依赖:代码执行 / 读写文件 / 第三方 API应用场景:文件转换

安装技能

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

执行命令安装此 skill: npx secure-skills-cli add audio-transcription
Metadata
name
audio-transcription
description
Transcreve arquivos de áudio para texto usando Whisper local ou API. Use quando o usuário solicitar transcrição de áudios, mensagens de voz, ou converter fala em texto. Suporta formatos OGG, MP3, WAV, M4A e outros via conversão automática.

Audio Transcription

Transcreve arquivos de áudio para texto.

Recursos

  • Transcrição de áudios em português e outros idiomas
  • Suporte a múltiplos formatos (OGG, MP3, WAV, M4A, etc.)
  • Conversão automática de formatos se necessário
  • Detecção automática de idioma

Como Usar

Pré-requisitos

A skill tenta usar as seguintes ferramentas na ordem:

  1. whisper (OpenAI Whisper via pip)
  2. whisper.cpp se instalado em ~/whisper.cpp
  3. API OpenAI (requer OPENAI_API_KEY)

Script de Transcrição

Use o script scripts/transcribe.sh:

scripts/transcribe.sh <arquivo_audio> [idioma]

Exemplo:

scripts/transcribe.sh /path/to/audio.ogg pt

Parâmetros

  • arquivo_audio: Caminho para o arquivo de áudio
  • idioma (opcional): Código do idioma (pt, en, es, etc.). Padrão: auto-detect

Instalação de Dependências

Se nenhuma ferramenta estiver disponível, a skill pode instalar whisper:

pip install openai-whisper

Para whisper.cpp local:

git clone https://github.com/ggerganov/whisper.cpp.git ~/whisper.cpp
cd ~/whisper.cpp
make

NOTAS

  • O formato OGG (Opus) do Telegram requer ffmpeg para conversão
  • A transcrição pode levar alguns segundos dependendo do tamanho do áudio
  • Qualidade da transcrição depende do modelo Whisper usado