openai-whisper-api

name	openai-whisper-api
description	Transcribe audio via OpenAI Audio Transcriptions API (Whisper).
homepage	https://platform.openai.com/docs/guides/speech-to-text
metadata	{"clawdbot":{"emoji":"☁️","requires":{"bins":["curl"],"env":["WHISPER_API_KEY"]},"primaryEnv":"WHISPER_API_KEY"}}

OpenAI Whisper API (curl)

Transcribe an audio file via OpenAI’s /v1/audio/transcriptions endpoint.

Quick start

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

Defaults:

• Model: provider-aware. It uses whisper-large-v3-turbo for Groq/vveai URLs and whisper-1 otherwise. Override with --model NAME or WHISPER_MODEL.
• Output: <input>.txt

Useful flags

{baseDir}/scripts/transcribe.sh /path/to/audio.ogg --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.json
{baseDir}/scripts/transcribe.sh /path/to/video.mp4 --srt --out /tmp/captions.srt

For --srt / --vtt the script always asks the API for verbose_json and assembles SRT/VTT locally, so the same flag works against providers (e.g. Groq) that don't emit SRT natively.

API key & base URL

Required env:

• WHISPER_API_KEY — your key. The helper falls back to OPENAI_API_KEY only when WHISPER_API_KEY is unset.

Optional env:

• WHISPER_BASE_URL — endpoint root, defaults to OPENAI_BASE_URL when set, otherwise https://api.groq.com/openai/v1. Include /v1 in the URL.
• WHISPER_TIMEOUT_SECONDS — request timeout; defaults to 300 seconds.