# 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.

- Skill: `modbender/aimlapi-voice` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add modbender/aimlapi-voice`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modbender/aimlapi-voice/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: modbender (https://skillmd.com/u/modbender)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/modbender/aimlapi-voice

---


# 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

```bash
# 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.

```bash
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_KEY` set in environment or provided via `--apikey-file`.