openai-whisper-api

Transcribes audio files to text or JSON via OpenAI's Audio Transcriptions API.

2|Updated May 23, 2026
One-click install
npx skills add https://github.com/enclawed/enclawed-oss --skill openai-whisper-api-enclawed
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openai-whisper-api
Source: https://github.com/enclawed/enclawed-oss/tree/main/skills/openai-whisper-api
Command: npx skills add https://github.com/enclawed/enclawed-oss --skill openai-whisper-api-enclawed

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill removes the manual work of converting spoken audio into text by sending audio files to OpenAI's transcription endpoint and saving the result automatically.

Core Features & Use Cases

  • Audio transcription: Convert common audio files into plain text or JSON transcripts.
  • Configurable speech-to-text requests: Choose the model, provide language hints, and add prompt context for better accuracy.
  • Flexible output handling: Write transcripts to a custom path or use the default filename derived from the input audio.
  • Use case: A user can transcribe meeting recordings, interview clips, or lecture audio directly from the terminal without building their own API client.

Quick Start

Set your OpenAI API key and run the transcription script on an audio file to generate a transcript in the default output format.

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 to text from the terminal?

Transcribing audio to text from the terminal involves using curl to send audio files to the OpenAI Audio Transcriptions API, which returns plain text or JSON transcripts without requiring a custom API client.

What do I need to run speech-to-text workflows with curl?

To run speech-to-text workflows with curl, you need the curl command-line tool, an audio file, and an OPENAI_API_KEY environment variable set for authenticating the transcription API requests.

Can I use OpenAI Whisper API with a custom base URL?

Yes, you can use OpenAI Whisper API with a custom base URL by setting the optional OPENAI_BASE_URL environment variable, allowing you to route transcription requests to OpenAI-compatible endpoints.

How can I improve transcription accuracy for lecture recordings?

To improve transcription accuracy for lecture recordings, you can provide optional language hints and prompt context parameters in your API request to guide the speech-to-text model's recognition.

Does this audio transcription method support custom output file paths?

Yes, this audio transcription method supports flexible output handling, allowing you to write transcripts to a custom path or automatically use a default filename derived from the input audio.