openai-whisper-api

Transcribe audio and video files via OpenAI-compatible Whisper transcription APIs.

39|1|Updated Jul 2, 2026
One-click install
npx skills add https://github.com/HKU-MMLab/UniClawBench --skill openai-whisper-api-hku-mmlab
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openai-whisper-api
Source: https://github.com/HKU-MMLab/UniClawBench/tree/main/injection/101_skill_usage/task_101_34_video_multilang/skills/openai-whisper-api
Command: npx skills add https://github.com/HKU-MMLab/UniClawBench --skill openai-whisper-api-hku-mmlab

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Converting audio or video recordings into text requires calling a speech-to-text API with the right model, format, and provider settings, which is tedious to script by hand. This Skill wraps the OpenAI Audio Transcriptions endpoint in a single curl-based command that handles provider detection, output formatting, and error checking. ## Core Features & Use Cases - Audio/Video Transcription: Send any audio or video file (m4a, ogg, mp4, etc.) to the /v1/audio/transcriptions endpoint and receive plain text, JSON, or verbose JSON output. - Subtitle Generation: Produce SRT or VTT caption files with timestamps by requesting verbose JSON and assembling subtitle cues locally, which works even against providers like Groq that do not emit SRT natively. - Provider-Aware Defaults: Automatically selects whisper-large-v3-turbo for Groq/vveai endpoints and whisper-1 otherwise, with overrides via --model or WHISPER_MODEL. - Use Case: Given a recorded interview saved as interview.m4a, run the transcribe script with --srt to produce timestamped captions ready for a video editor. ## Quick Start Transcribe the attached audio file into text using the Whisper transcription script, optionally adding --srt to get timestamped subtitles.

Frequently Asked Questions about openai-whisper-api

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I transcribe an audio file with the OpenAI Whisper API?▼

Run the transcribe.sh script with your audio file path, for example transcribe.sh /path/to/audio.m4a. It posts the file to the /v1/audio/transcriptions endpoint and writes a plain text transcript next to the input by default.

How to generate SRT subtitles from a video file using Whisper?▼

Pass the --srt flag with your video file, such as transcribe.sh video.mp4 --srt --out captions.srt. The script requests verbose_json from the API and assembles SRT cues locally, so it works even with providers that do not emit SRT natively.

Can I use Groq instead of OpenAI for Whisper transcription?▼

Yes, set WHISPER_BASE_URL to https://api.groq.com/openai/v1 or leave it unset since Groq is the default endpoint. The script automatically uses the whisper-large-v3-turbo model for Groq and vveai URLs.

What environment variables does the Whisper transcription script need?▼

WHISPER_API_KEY is required, falling back to OPENAI_API_KEY when unset. Optional variables include WHISPER_BASE_URL, WHISPER_MODEL, and WHISPER_TIMEOUT_SECONDS which defaults to 300 seconds.

Why does my Whisper transcription request fail with an HTTP error?▼

Failures usually come from a missing or invalid API key, an unreachable base URL, or a timeout on large files. The script prints the HTTP status and the API error body to stderr to help diagnose the issue.