openai-whisper-api

Transcribes audio files into text using OpenAI's Whisper API.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

It solves the need to convert spoken audio files into accurate written transcripts quickly, without manual listening and typing.

Core Features & Use Cases

  • Audio Transcription: Transcribe supported audio files into text using OpenAI’s /v1/audio/transcriptions endpoint.
  • Model, Language, and Prompt Control: Choose the transcription model, optionally set the language, and provide a prompt to guide wording such as speaker names.
  • Flexible Output Formats: Produce plain text output by default or request JSON output for programmatic downstream processing.

Use Case: You have a directory of meeting recordings (e.g., .m4a or .ogg) and want to generate searchable transcripts for each recording, optionally preserving metadata-friendly JSON outputs.

Quick Start

Set OPENAI_API_KEY and run the provided transcribe script on your audio file to generate an automatic transcript text file.

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

To transcribe audio files to text, run the provided curl-based script against OpenAI's /v1/audio/transcriptions endpoint. You need a valid OPENAI_API_KEY to process recordings like meeting notes or podcasts into searchable text transcripts.

Can I get JSON output from speech-to-text transcription for programmatic processing?

Yes, you can get JSON output from the speech-to-text transcription. The script defaults to plain text but supports parameters to request JSON output, allowing you to generate metadata-friendly files for downstream programmatic processing.

Do I need curl to use this OpenAI audio transcription script?

Yes, you need curl installed to use this OpenAI audio transcription script. The Skill relies exclusively on a curl-based script to call the Whisper API and transcribe your audio files into text or JSON formats.

What is the best way to guide speaker names and wording during audio transcription?

The best way to guide wording during audio transcription is to use the prompt parameter. Supplying a prompt helps the Whisper model preserve specific context like speaker names, ensuring accurate transcripts for your meeting recordings.

Does this OpenAI Whisper transcription script support setting the language and model?

Yes, this OpenAI Whisper transcription script supports setting both the language and model. You can choose the transcription model, optionally set the language, and provide a prompt to ensure accurate speech-to-text conversion.

What audio formats can I batch transcribe for meeting recordings?

You can batch transcribe meeting recordings in formats like .m4a or .ogg. The script processes supported audio files through the OpenAI Whisper API, generating automatic searchable transcripts for each recording in your directory.