openai-whisper-api

Transcribe m4a and ogg audio files via the OpenAI Whisper API.

Updated Apr 8, 2026
One-click install
npx skills add https://github.com/JOHNNYWHITEMIKE/openclaw --skill openai-whisper-api-johnnywhitemike
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openai-whisper-api
Source: https://github.com/JOHNNYWHITEMIKE/openclaw/tree/main/openclaw/.openclaw/openclaw/skills/openai-whisper-api
Command: npx skills add https://github.com/JOHNNYWHITEMIKE/openclaw --skill openai-whisper-api-johnnywhitemike

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl, and includes scripts (resource) components.

What problem does it solve?

It solves the problem of converting spoken audio into accurate written transcripts without manual listening and typing.

Core Features & Use Cases

  • Audio transcription via OpenAI API: Transcribes audio files using OpenAI’s /v1/audio/transcriptions endpoint.
  • Model and output control: Lets you choose the Whisper model and whether you want text output or JSON output.
  • Language, prompts, and proxy support: Supports specifying a language and prompt hints, and can use an OpenAI-compatible proxy via OPENAI_BASE_URL.

Quick Start

Run {baseDir}/scripts/transcribe.sh /path/to/audio.m4a to generate a transcript file next to the input audio (defaulting to whisper-1).

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 m4a audio to text using OpenAI Whisper API?

To transcribe m4a audio to text, run the transcribe.sh script with your audio file path. It performs an authenticated multipart upload to the OpenAI /audio/transcriptions endpoint and outputs a text file next to the input.

What audio formats can I convert to JSON output using curl?

You can convert m4a and ogg audio files to JSON output using curl. The skill sends a multipart upload to the OpenAI API, letting you specify the whisper-1 model and JSON as the response_format parameter.

Do I need an OPENAI_API_KEY to perform speech-to-text conversion?

Yes, you need an OPENAI_API_KEY to perform speech-to-text conversion. The script uses this key for authenticated requests to the /v1/audio/transcriptions endpoint, and optionally accepts an OPENAI_BASE_URL for proxy support.

Can I specify a language when transcribing audio with the whisper-1 model?

Yes, you can specify a language when transcribing audio with the whisper-1 model. The skill supports adding language parameters and prompt hints to improve transcription accuracy for your speech-to-text conversion tasks.

What is the best way to get structured JSON from speech-to-text transcription?

The best way to get structured JSON from speech-to-text transcription is to set the response_format parameter to JSON. This skill performs the authenticated upload via curl and returns structured output directly from the Whisper API.

How does a multipart upload to the audio transcriptions endpoint work?

A multipart upload to the audio transcriptions endpoint sends your audio file along with model, language, and response_format parameters via curl. The Whisper API processes the speech-to-text request and returns the converted text or JSON output.