speechall-cli

CLI for speech-to-text transcription via the Speechall API. Supports multiple providers (OpenAI, Deepgram, AssemblyAI, Google, Gemini, Groq, ElevenLabs, Cloudflare, and more).

Installation

Homebrew (macOS and Linux)

brew install Speechall/tap/speechall

Without Homebrew: Download the binary for your platform from https://github.com/Speechall/speechall-cli/releases and place it on your PATH.

Verify

speechall --version

Authentication

An API key is required. Provide it via environment variable (preferred) or flag:

export SPEECHALL_API_KEY="your-key-here"
# or
speechall --api-key "your-key-here" audio.wav

The user can create an API key on https://speechall.com/console/api-keys

Commands

transcribe (default)

Transcribe an audio or video file. This is the default subcommand — speechall audio.wav is equivalent to speechall transcribe audio.wav.

speechall <file> [options]

Options:

| Flag | Description | Default | |---|---|---| | --model <provider.model> | STT model identifier | openai.gpt-4o-mini-transcribe | | --language <code> | Language code (e.g. en, tr, de) | API default (auto-detect) | | --output-format <format> | Output format (text, json, verbose_json, srt, vtt) | API default | | --diarization | Enable speaker diarization | off | | --speakers-expected <n> | Expected number of speakers (use with --diarization) | — | | --no-punctuation | Disable automatic punctuation | — | | --temperature <0.0-1.0> | Model temperature | — | | --initial-prompt <text> | Text prompt to guide model style | — | | --custom-vocabulary <term> | Terms to boost recognition (repeatable) | — | | --ruleset-id <uuid> | Replacement ruleset UUID | — | | --api-key <key> | API key (overrides SPEECHALL_API_KEY env var) | — |

Examples:

# Basic transcription
speechall interview.mp3

# Specific model and language
speechall call.wav --model deepgram.nova-2 --language en

# Speaker diarization with SRT output
speechall meeting.wav --diarization --speakers-expected 3 --output-format srt

# Custom vocabulary for domain-specific terms
speechall medical.wav --custom-vocabulary "myocardial" --custom-vocabulary "infarction"

# Transcribe a video file (macOS extracts audio automatically)
speechall presentation.mp4

models

List available speech-to-text models. Outputs JSON to stdout. Filters combine with AND logic.

speechall models [options]

Filter flags:

| Flag | Description | |---|---| | --provider <name> | Filter by provider (e.g. openai, deepgram) | | --language <code> | Filter by supported language (tr matches tr, tr-TR, tr-CY) | | --diarization | Only models supporting speaker diarization | | --srt | Only models supporting SRT output | | --vtt | Only models supporting VTT output | | --punctuation | Only models supporting automatic punctuation | | --streamable | Only models supporting real-time streaming | | --vocabulary | Only models supporting custom vocabulary |

Examples:

# List all available models
speechall models

# Models from a specific provider
speechall models --provider deepgram

# Models that support Turkish and diarization
speechall models --language tr --diarization

# Pipe to jq for specific fields
speechall models --provider openai | jq '.[].identifier'

Tips

• On macOS, video files (.mp4, .mov, etc.) are automatically converted to audio before upload.
• On Linux, pass audio files directly (.wav, .mp3, .m4a, .flac, etc.).
• Output goes to stdout. Redirect to save: speechall audio.wav > transcript.txt
• Errors go to stderr, so piping stdout is safe.
• Run speechall --help, speechall transcribe --help, or speechall models --help to see all valid enum values for model identifiers, language codes, and output formats.