openai-whisper-api

Transcribe audio files to text via the OpenAI Audio Transcriptions API.

8|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/SenseTime-FVG/sensenova-claw --skill openai-whisper-api-sensetime-fvg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openai-whisper-api
Source: https://github.com/SenseTime-FVG/sensenova-claw/tree/main/.sensenova-claw/skills/openai-whisper-api
Command: npx skills add https://github.com/SenseTime-FVG/sensenova-claw --skill openai-whisper-api-sensetime-fvg

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automates converting audio files into accurate text transcripts by using the OpenAI Audio Transcriptions (Whisper) API, eliminating manual transcription work.

Core Features & Use Cases

  • Curl-based CLI Script: Includes a ready-to-run transcribe.sh that uploads audio to OpenAI's /v1/audio/transcriptions endpoint.
  • Flexible Options: Supports model selection, language hints, prompt hints, and output format selection between text and JSON.
  • Use Case: Ideal for transcribing meeting recordings, interviews, podcasts, or short voice notes into searchable text files for documentation and analysis.

Quick Start

Run the transcribe.sh script with the path to your audio file to produce a transcript 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 using the OpenAI Whisper API?

Transcribe audio files by running a shell script that uploads recordings to the OpenAI Audio Transcriptions API endpoint. The script uses curl to send the audio file and returns the converted text, automating the speech-to-text process.

Do I need curl and an OpenAI API key to run speech-to-text scripts?

Yes, you need curl installed locally and a valid OPENAI_API_KEY configured in your environment. These two prerequisites allow the shell script to authenticate and upload audio files to the OpenAI Audio Transcriptions endpoint.

Can I specify the language or provide a prompt hint when transcribing audio?

Yes, the transcription script supports language hints and prompt hints to improve accuracy for specific contexts. You can also select the output format, choosing between plain text and JSON for the returned transcript.

What is the best way to transcribe short podcasts or meeting recordings in a shell workflow?

Using a curl-based CLI script is the best way to transcribe short podcasts or meetings in shell workflows. It automates uploading audio files to the Whisper API and outputs searchable text files for documentation and analysis.

Does the OpenAI Audio Transcriptions API support JSON output for interview transcripts?

Yes, the API supports both text and JSON output formats for interview transcripts. You can configure the script to return JSON, providing structured transcription data suitable for further automated processing.

What are the limitations of using the Whisper API for audio transcription?

The Whisper API is ideal for short recordings, interviews, meetings, and podcasts, but may have limitations with very long audio files or poor audio quality. It requires a valid OpenAI API key and curl installed locally to function.