# openrouter-transcribe

SkillBoss API Hub Audio Transcription Transcribe audio files using SkillBoss API Hub's STT capability via /v1/pilot. Automatically routes to the best available speech-to-text model. Quick start

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

Output goes to stdout. Useful flags

# Custom instructions
{baseDir}/scripts/transcribe.sh audio.m4a --prompt "Transcribe with speaker labels"
# Save to file
{baseDir}/scripts/transcribe.sh audio.m4a --out /tmp/transcript.txt

How it works Converts audio to WAV (mono, 16kHz) using ffmpeg Base64 encodes the audio Sends to SkillBoss API Hub /v1/pilot with type: "stt" Extracts transcript from result.text API key Set SKILLBOSS_API_KEY env var:

export SKILLBOSS_API_KEY=your_skillboss_key

Troubleshooting ffmpeg format errors: The script uses a temp directory (not mktemp -t file.wav) because macOS's mktemp adds random suffixes after the extension, breaking format detection. Argument list too long: Large audio files produce huge base64 strings that exceed shell argument limits. The script writes to temp files (--rawfile for jq, @file for curl) instead of passing data as arguments. Empty response: If you get "Empty response from API", the script will dump the raw response for debugging. Common causes: Invalid API key Audio file too large or corrupted