OP

openai-whisper-api

Use the OpenAI Audio API to transcribe audio files via command line. Supports various models including Whisper-1 and GPT-4o-transcribe.

Install

mkdir -p .claude/skills/openai-whisper-api && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/2141" && unzip -o skill.zip -d .claude/skills/openai-whisper-api && rm skill.zip

Installs to .claude/skills/openai-whisper-api

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

OpenAI Audio Transcriptions API via curl; gpt-4o-transcribe, mini, diarize, or whisper-1.
89 charsno explicit “when” trigger
Beginner

Key capabilities

  • Transcribe audio files using OpenAI API models
  • Enable speaker diarization for transcript labeling
  • Specify source language for improved accuracy
  • Provide custom prompts for speaker identification
  • Output transcripts in text or JSON formats

How it works

The skill interfaces with the OpenAI /v1/audio/transcriptions endpoint via curl. It supports various models and flags to handle diarization, language settings, and output formatting.

Inputs & outputs

You give it
Audio file path
You get back
Transcription text or JSON file

When to use openai-whisper-api

  • Convert audio recordings to text
  • Generate transcripts with speaker diarization
  • Process m4a or wav files for documentation

About this skill

OpenAI transcriptions API

Transcribe audio through /v1/audio/transcriptions. Set OPENAI_BASE_URL for an OpenAI-compatible proxy or local gateway.

Quick start

{baseDir}/scripts/transcribe.sh /path/to/audio.m4a

Defaults:

  • Model: gpt-4o-transcribe
  • Output: <input>.txt

Useful flags

{baseDir}/scripts/transcribe.sh /path/to/audio.ogg --model gpt-4o-transcribe --out /tmp/transcript.txt
{baseDir}/scripts/transcribe.sh /path/to/audio.ogg --model gpt-4o-mini-transcribe
{baseDir}/scripts/transcribe.sh /path/to/audio.ogg --model gpt-4o-transcribe-diarize --json
{baseDir}/scripts/transcribe.sh /path/to/audio.ogg --model whisper-1
{baseDir}/scripts/transcribe.sh /path/to/audio.m4a --language en
{baseDir}/scripts/transcribe.sh /path/to/audio.m4a --prompt "Speaker names: Peter, Daniel"
{baseDir}/scripts/transcribe.sh /path/to/audio.m4a --json --out /tmp/transcript.json

Notes:

  • Supported upload formats include mp3, mp4, mpeg, mpga, m4a, wav, webm.
  • 25 MB upload limit on the hosted API.
  • Use diarize for speaker labels; script sends chunking_strategy=auto and rejects --prompt.

API key

Set OPENAI_API_KEY, or configure it in the active OpenClaw config file ($OPENCLAW_CONFIG_PATH, default ~/.openclaw/openclaw.json). Optionally set OPENAI_BASE_URL:

{
  skills: {
    "openai-whisper-api": {
      apiKey: "OPENAI_KEY_HERE",
    },
  },
}

When not to use it

  • When audio files exceed the 25 MB API upload limit

Prerequisites

curlnodeOPENAI_API_KEY

Limitations

  • Diarization mode rejects custom prompts
  • Restricted to supported audio formats like mp3, wav, and m4a

How it compares

This script automates the API interaction and file handling process, avoiding the need for manual curl requests and local environment configuration.

Compared to similar skills

openai-whisper-api side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
openai-whisper-api (this skill)22moReviewBeginner
telegram-bot-builder1066moReviewIntermediate
playwright-browser-automation297moReviewIntermediate
workflow-orchestration-patterns102moNo flagsAdvanced

Try saying

Example prompts that trigger this skill in your AI assistant.

You might also like

telegram-bot-builder

davila7

Expert in building Telegram bots that solve real problems - from simple automation to complex AI-powered bots. Covers bot architecture, the Telegram Bot API, user experience, monetization strategies, and scaling bots to thousands of users. Use when: telegram bot, bot api, telegram automation, chat bot telegram, tg bot.

106130

playwright-browser-automation

lackeyjb

Complete browser automation with Playwright. Auto-detects dev servers, writes clean test scripts to /tmp. Test pages, fill forms, take screenshots, check responsive design, validate UX, test login flows, check links, automate any browser task. Use when user wants to test websites, automate browser interactions, validate web functionality, or perform any browser-based testing.

29146

workflow-orchestration-patterns

wshobson

Design durable workflows with Temporal for distributed systems. Covers workflow vs activity separation, saga patterns, state management, and determinism constraints. Use when building long-running processes, distributed transactions, or microservice orchestration.

10117

codex-skill

feiskyer

Use when user asks to leverage codex, gpt-5, or gpt-5.1 to implement something (usually implement a plan or feature designed by Claude). Provides non-interactive automation mode for hands-off task execution without approval prompts.

12110

bullmq-specialist

davila7

BullMQ expert for Redis-backed job queues, background processing, and reliable async execution in Node.js/TypeScript applications. Use when: bullmq, bull queue, redis queue, background job, job queue.

2595

n8n-expression-syntax

czlonkowski

Validate n8n expression syntax and fix common errors. Use when writing n8n expressions, using {{}} syntax, accessing $json/$node variables, troubleshooting expression errors, or working with webhook data in workflows.

6111

Search skills

Search the agent skills registry