skills.rest
JEROME-PRAKASH-L
JEROME-PRAKASH-LCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

openai-whisper-api

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

1|Updated Jun 9, 2026
Search Tags:#transcription#whisper#audio#openai#curl#speech-to-text#diarization
One-click install
npx skills add https://github.com/JEROME-PRAKASH-L/openclaw --skill openai-whisper-api-jerome-prakash-l
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openai-whisper-api
Source: https://github.com/JEROME-PRAKASH-L/openclaw/tree/main/skills/openai-whisper-api
Command: npx skills add https://github.com/JEROME-PRAKASH-L/openclaw --skill openai-whisper-api-jerome-prakash-l

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Converting audio recordings into text manually is slow and error-prone. This Skill sends audio files to the OpenAI Audio Transcriptions API and returns clean transcripts, including optional speaker labels, without requiring you to write API integration code. ## Core Features & Use Cases - Multiple transcription models: Choose between gpt-4o-transcribe, gpt-4o-mini-transcribe, gpt-4o-transcribe-diarize for speaker labels, or whisper-1. - Flexible output: Write plain text transcripts by default or full JSON responses with segment and speaker data. - Language and prompt hints: Pass a language code or vocabulary prompt to improve recognition of names and domain terms. - Use Case: You recorded a meeting as an m4a file and need a speaker-labeled transcript. Run the script with the diarize model to get a transcript with each line prefixed by the speaker name. ## Quick Start Ask the assistant to transcribe your audio file, for example: transcribe the file meeting.m4a using the openai-whisper-api skill with speaker diarization enabled.

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 with the OpenAI API?▼

Run the transcribe.sh script with your audio file path, for example transcribe.sh audio.m4a. It uploads the file to /v1/audio/transcriptions with the gpt-4o-transcribe model and writes the transcript to a .txt file next to the input.

How do I get speaker labels in an OpenAI transcription?▼

Use the gpt-4o-transcribe-diarize model with the --model flag. The script sends chunking_strategy=auto and formats the response segments as speaker-prefixed lines. Note that --prompt is not supported with this model.

What audio formats does the OpenAI transcription API support?▼

Supported upload formats include mp3, mp4, mpeg, mpga, m4a, wav, and webm. The hosted API enforces a 25 MB upload limit per file, so larger recordings must be split before transcription.

Can I use a local or proxy endpoint instead of api.openai.com?▼

Yes, set the OPENAI_BASE_URL environment variable to any OpenAI-compatible proxy or local gateway. The script appends /audio/transcriptions to that base URL instead of the default hosted endpoint.

Why does transcription fail with a missing API key error?▼

The script exits if OPENAI_API_KEY is not set in the environment. Export the key in your shell or configure it under skills.openai-whisper-api.apiKey in the OpenClaw config file at ~/.openclaw/openclaw.json.

Related Skills

Explore More Content & Communication Skills→
pchemguypchemguy

transcribe

Transcribe audio files to text with optional speaker diarization using OpenAI models.

Community
Intermediate
mostafa-K-raihanmostafa-K-raihan

podcast-synthesize

Convert YouTube podcasts into structured markdown knowledge notes with transcript metadata.

Community
Advanced
JigsawStackJigsawStack
4

speech-to-text

Convert spoken audio into searchable transcripts with timestamps and speaker labels.

Official
Intermediate
adbertramadbertram
3

whisper-cli

Transcribe local audio and video files into timestamped JSON transcripts using whisper.cpp.

Community
Intermediate