openai-whisper-api

Transcribe local audio files to text or JSON via OpenAI's Whisper API.

Updated Mar 21, 2026
One-click install
npx skills add https://github.com/Polealpha/XINNIAN_PI --skill openai-whisper-api-polealpha
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openai-whisper-api
Source: https://github.com/Polealpha/XINNIAN_PI/tree/main/app%20windows/vendor/openclaw-runtime/skills/openai-whisper-api
Command: npx skills add https://github.com/Polealpha/XINNIAN_PI --skill openai-whisper-api-polealpha

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Transcription turns spoken audio into readable text so you can search, summarize, or use it in downstream workflows without manual typing.

Core Features & Use Cases

  • Audio-to-Text Transcription: Sends an audio file to OpenAI’s /v1/audio/transcriptions endpoint and saves the result as a text or JSON output.
  • Model and Language Controls: Selects a Whisper model and optionally specifies language and prompt hints for better recognition.
  • Use Case: Convert a recorded meeting or lecture (.m4a, .ogg, etc.) into a transcript you can paste into notes, create subtitles from, or feed into an analysis pipeline.

Quick Start

Run the transcribe script with your audio file path to generate a .txt transcript beside the input.

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 using the OpenAI Whisper API?

To transcribe an audio file using the OpenAI Whisper API, run the provided transcribe script with your local audio file path. It sends a multipart upload to the audio transcriptions endpoint and saves a generated text or JSON output.

Do I need an OpenAI API key to convert speech to text with curl?

Yes, converting speech to text with curl requires a valid OPENAI_API_KEY and a reachable OpenAI API endpoint. The script uses these credentials to authenticate the multipart file upload request to the Whisper model.

Can I specify the language or add a prompt hint for audio transcription?

Yes, you can specify the language and add optional prompt hints for audio transcription. These parameters are sent alongside the model and audio file in the multipart upload to improve speech recognition accuracy.

What audio file formats work for generating text transcripts from recordings?

The transcription process supports common audio file formats like .m4a and .ogg for generating text transcripts. It processes these local audio files through the OpenAI Whisper API to output plain text or JSON.

What is the best way to automate speech-to-text transcription for meetings?

The best way to automate speech-to-text transcription for meetings is running a script that sends local audio recordings to the OpenAI Whisper API. This automatically converts the spoken audio into readable text or JSON output.

Why does my curl audio transcription return a plain text file instead of JSON?

Your curl audio transcription returns a plain text file instead of JSON based on the selected output configuration. The script can save the Whisper API response as either standard text or structured JSON output.