OpenAI Whisper API (curl)

SkillMedia

Lets your agent turn audio files into text transcripts using OpenAI's Whisper speech-to-text service.

Then ask your AI: use the OpenAI Whisper API (curl) skill

Details

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Add it as a step in a pipeline you build on Ahel, or connect Ahel to Claude, ChatGPT, Cursor, Claude Code or Codex and ask your AI to use it.

About this skill

Transcribe audio via OpenAI Audio Transcriptions API (Whisper).

What this skill tells your AI

The instructions your AI receives, as published by the-open-agent/openagent in skills/openai-whisper-api/SKILL.md and read by Ahel’s review.

Transcribe an audio file via OpenAI's /v1/audio/transcriptions endpoint. Set OPENAI_BASE_URL to use an OpenAI-compatible proxy or local gateway.

Quick start

curl -sS "https://api.openai.com/v1/audio/transcriptions" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -F "file=@/path/to/audio.m4a" \
  -F "model=whisper-1" \
  -F "response_format=text" \
  > transcript.txt

Defaults:

  • Model: whisper-1
  • Output format: text

Options

# With language hint
curl -sS "https://api.openai.com/v1/audio/transcriptions" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -F "file=@audio.ogg" \
  -F "model=whisper-1" \
  -F "response_format=text" \
  -F "language=en" \
  > transcript.txt

# With speaker hint (prompt)
curl -sS "https://api.openai.com/v1/audio/transcriptions" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -F "file=@audio.m4a" \
  -F "model=whisper-1" \
  -F "response_format=text" \
  -F "prompt=Speaker names: Peter, Daniel" \
  > transcript.txt

# JSON output
curl -sS "https://api.openai.com/v1/audio/transcriptions" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -F "file=@audio.m4a" \
  -F "model=whisper-1" \
  -F "response_format=json" \
  > transcript.json

Custom base URL

Set OPENAI_BASE_URL to use an OpenAI-compatible proxy or local gateway:

API_BASE="${OPENAI_BASE_URL:-https://api.openai.com/v1}"
curl -sS "${API_BASE}/audio/transcriptions" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -F "file=@audio.m4a" \
  -F "model=whisper-1" \
  -F "response_format=text" \
  > transcript.txt

API key

Set OPENAI_API_KEY environment variable before running commands.

Signals

GitHub stars
6k
Forks
666
Last commit
Oct 2026

Ahel review

  • S4info
    community integration, published by the-open-agent, not openai

Automated review, not a security audit. Ruleset v1+k2.

Advanced
Item type
skill
Key
openai-whisper-api-the-open-agent
Source
github.com/the-open-agent/openagent