
Openai Whisper Api
- 8 installs
- 33 repo stars
- Updated April 26, 2026
- bighardperson/computer-science-skills-collection
openai-whisper-api is a Claude skill that transcribes audio files into text or JSON by calling OpenAI's Whisper transcription endpoint through a shell script.
About
openai-whisper-api transcribes an audio file by calling OpenAI's /v1/audio/transcriptions endpoint through a bundled transcribe.sh script. A developer runs it to turn recordings like m4a or ogg files into a text or JSON transcript. It supports flags for model, language, output path, and a prompt hint.
- Wraps OpenAI's /v1/audio/transcriptions (Whisper) via a transcribe.sh curl script
- Outputs plain text by default or JSON with --json
- Accepts --model, --language, --out, and --prompt flags
Openai Whisper Api by the numbers
- 8 all-time installs (skills.sh)
- Ranked #1,522 of 2,719 Automation & Workflows skills by installs in the Skillselion catalog
- Data as of Jul 30, 2026 (Skillselion catalog sync)
openai-whisper-api capabilities & compatibility
Requires an OpenAI API key; usage billed by OpenAI per audio minute.
- Capabilities
- transcription · speech to text
- Works with
- openai
- Use cases
- transcription
- Pricing
- Bring your own API key
What openai-whisper-api says it does
Transcribe an audio file via OpenAI's `/v1/audio/transcriptions` endpoint.
Set `OPENAI_API_KEY` environment variable.
npx skills add https://github.com/bighardperson/computer-science-skills-collection --skill openai-whisper-apiAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 8 |
|---|---|
| repo stars | ★ 33 |
| Last updated | April 26, 2026 |
| Repository | bighardperson/computer-science-skills-collection ↗ |
What it does
Transcribe an audio recording into a text or JSON file from the command line via the OpenAI Whisper API.
Who is it for?
One-off or scripted transcription of local audio files with an OpenAI API key.
When should I use this skill?
You have an audio file and want a text transcript via the OpenAI Whisper API.
What you get
A transcript file (.txt or .json) produced from the input audio.
- Text or JSON transcript of the input audio
By the numbers
- Defaults to the whisper-1 model
- Supports 4 documented flags: --model, --out, --language, --prompt
Files
OpenAI Whisper API (curl)
Transcribe an audio file via OpenAI's /v1/audio/transcriptions endpoint.
Quick start
{baseDir}/scripts/transcribe.sh /path/to/audio.m4aDefaults:
- Model:
whisper-1 - Output:
<input>.txt
Useful flags
{baseDir}/scripts/transcribe.sh /path/to/audio.ogg --model whisper-1 --out /tmp/transcript.txt
{baseDir}/scripts/transcribe.sh /path/to/audio.m4a --language en
{baseDir}/scripts/transcribe.sh /path/to/audio.m4a --prompt "Speaker names: Peter, Daniel"
{baseDir}/scripts/transcribe.sh /path/to/audio.m4a --json --out /tmp/transcript.jsonAPI key
Set OPENAI_API_KEY environment variable.
#!/usr/bin/env bash
set -euo pipefail
usage() {
cat >&2 <<'EOF'
Usage:
transcribe.sh <audio-file> [--model whisper-1] [--out /path/to/out.txt] [--language en] [--prompt "hint"] [--json]
EOF
exit 2
}
if [[ "${1:-}" == "" || "${1:-}" == "-h" || "${1:-}" == "--help" ]]; then
usage
fi
in="${1:-}"
shift || true
model="whisper-1"
out=""
language=""
prompt=""
response_format="text"
while [[ $# -gt 0 ]]; do
case "$1" in
--model)
model="${2:-}"
shift 2
;;
--out)
out="${2:-}"
shift 2
;;
--language)
language="${2:-}"
shift 2
;;
--prompt)
prompt="${2:-}"
shift 2
;;
--json)
response_format="json"
shift 1
;;
*)
echo "Unknown arg: $1" >&2
usage
;;
esac
done
if [[ ! -f "$in" ]]; then
echo "File not found: $in" >&2
exit 1
fi
if [[ "${OPENAI_API_KEY:-}" == "" ]]; then
echo "Missing OPENAI_API_KEY" >&2
exit 1
fi
if [[ "$out" == "" ]]; then
base="${in%.*}"
if [[ "$response_format" == "json" ]]; then
out="${base}.json"
else
out="${base}.txt"
fi
fi
mkdir -p "$(dirname "$out")"
curl -sS https://api.openai.com/v1/audio/transcriptions \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Accept: application/json" \
-F "file=@${in}" \
-F "model=${model}" \
-F "response_format=${response_format}" \
${language:+-F "language=${language}"} \
${prompt:+-F "prompt=${prompt}"} \
>"$out"
echo "$out"
Related skills
FAQ
What model does openai-whisper-api use?
It defaults to the whisper-1 model, and you can override it with the --model flag.
What output does it produce?
By default it writes a .txt transcript next to the input; with --json it writes a JSON file to the path you set with --out.