Back to Skills

openai-whisper-api

Transcribe audio via OpenAI Audio Transcriptions API (Whisper).

207,198stars37,962forksUpdated 2/18/2026

Security Assessment

Safe(100/100)
Security Score100/100

About openai-whisper-api

The OpenAI Whisper API skill allows users to transcribe audio content into text using OpenAI's Whisper model via the `/v1/audio/transcriptions` endpoint. This API facilitates the conversion of various audio formats into readable text, making it highly useful for applications that require speech-to-text capabilities, such as transcription services, voice assistants, and accessibility tools. By leveraging OpenAI’s Whisper model, users can easily obtain accurate transcriptions for a wide variety of audio files, improving workflows that depend on textual representations of spoken content.

This skill offers several capabilities, such as specifying the model version to use (defaulting to `whisper-1`), selecting the output format (e.g., plain text or JSON), and customizing transcription parameters such as language or speaker identification. The API requires an active OpenAI API key for authentication and can be executed via a simple curl command. Additionally, it allows users to provide specific prompts to enhance the accuracy of transcriptions. With straightforward setup steps, including API key configuration and the ability to choose output paths, it caters to both developers and end-users seeking reliable transcription solutions. Ideal for transcribing meetings, lectures, podcasts, or any audio content that requires textual conversion, it’s especially valuable for individuals and teams in media production, research, and content creation.

FAQ

How do I start using the OpenAI Whisper API?

To get started, simply run the `transcribe.sh` script with the path to your audio file. For example, use `{baseDir}/scripts/transcribe.sh /path/to/audio.m4a`. You will need to have the `OPENAI_API_KEY` set up in your environment or in the configuration file (`~/.openclaw/openclaw.json`).

What file formats are supported for transcription?

The API supports a variety of audio formats, including `.m4a`, `.ogg`, and other common audio file types. You can specify the input file format when using the script.

Do I need any special software or dependencies?

Yes, you will need the `curl` command-line tool and an active OpenAI API key. These dependencies are required to interact with the API successfully.

Can I specify the language of the audio for transcription?

Yes, you can specify the language of the audio by using the `--language` flag. For example, to transcribe English audio, you can use the flag `--language en`.

Are there any limitations to the transcription output?

The output of the transcription can be either a plain text file or a JSON file, depending on the flags used. However, the API may not perform well with low-quality or heavily accented audio. Accuracy is best with clear speech and standard accents.

Install openai-whisper-api

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill