aimlapi-voice
// Transcribe audio files (ogg, mp3, wav, etc.) using AIMLAPI. Use when the user provides audio messages or local audio files. Provides a reliable Python script with retries and polling.
$ git log --oneline --stat
stars:1,933
forks:367
updated:March 4, 2026
SKILL.mdreadonly
SKILL.md Frontmatter
nameaimlapi-voice
descriptionTranscribe audio files (ogg, mp3, wav, etc.) using AIMLAPI. Use when the user provides audio messages or local audio files. Provides a reliable Python script with retries and polling.
metadata[object Object]
AIMLAPI Voice Transcription
Overview
A robust skill for transcribing audio via AIMLAPI's specialized speech-to-text endpoints. It handles queuing, polling for results, and automatic MIME-type detection.
Quick Start
# Set your API key first (if not in env)
# export AIMLAPI_API_KEY="your-key-here"
# Transcribe a file
python {baseDir}/scripts/transcribe.py path/to/audio.ogg
Tasks
Process Voice Messages
When an audio file is received, use this script to extract the text.
python {baseDir}/scripts/transcribe.py <file_path> \
--model "#g1_whisper-medium" \
--verbose
Arguments
file: (Required) Path to the audio file.--model: Model ID (default:#g1_whisper-medium).--out: Path to save the transcript text.--poll-interval: Seconds between status checks (default: 5).--max-wait: Stop waiting after N seconds (default: 300).
Dependencies
- Python 3
AIMLAPI_API_KEYset in environment or provided via--apikey-file.