Terminal
Terminal/Skill
For terminal users: transcribe local files and URLs with the Gladia CLI, then ask questions about the transcript.
By Gladia
Works with
npx skills add gladiaio/skills --skill gladia-using-cliThe Gladia CLI (gladia) transcribes pre-recorded audio from the terminal. Local files are auto-uploaded; URLs are passed directly to the API.
CLI vs SDK: use the CLI for quick terminal workflows when
gladiais on PATH. For app integration or audio intelligence not exposed as CLI flags, see gladia-sdk-integration and gladia-audio-intelligence.
gladia transcribe, or wants quick terminal transcriptionhttp(s) URL, or a YouTube URL, then answer follow-up questions about the contentPrerequisites: verify gladia --version succeeds and an API key is configured (GLADIA_API_KEY, ~/.gladia, or --gladia-key).
Consult these resources as needed:
Install (macOS/Linux):
curl -fsSL https://github.com/gladiaio/gladia-cli/releases/latest/download/install.sh | sh
Auth — get a key at app.gladia.io/account. Three options:
# 1. Environment variable (preferred for CI and shells)
export GLADIA_API_KEY=<API_KEY>
# 2. Persist locally
gladia auth set <API_KEY>
# 3. Pass per command (global flag, works on any command)
gladia transcribe meeting.wav --gladia-key <API_KEY>
Credential order: GLADIA_API_KEY → ~/.gladia → --gladia-key (first match wins)
List valid language codes: gladia languages
| Command | Description |
|---|---|
gladia transcribe <source> | Transcribe a local file, a http(s) URL, or a YouTube URL |
gladia auth set <key> | Save API key to ~/.gladia |
gladia languages | List supported ISO 639-1 codes |
| Flag | Default | Description |
|---|---|---|
-o, --output | text | text, json, json-full, srt, vtt |
--language | — | Expected language(s), comma-separated (en or en,fr,de) |
--code-switching, --code-switch | off | Detect language per utterance |
--diarize | off | Speaker identification |
--model | API default | solaria-1 or solaria-3 |
-v, --verbose | off | Show progress while polling |
Global: --gladia-key — API key override
gladia --version; install or use SDK skills if missinggladia transcribe <source> [flags]; capture stdout-v for progress; for very long transcripts, redirect stdout to a temp file and read selectivelyDo not invent transcript content. If output is empty or unclear, say so and suggest different flags or SDK skills.
| User need | CLI approach |
|---|---|
| Plain transcript | default or -o text |
| Who spoke when | --diarize -o text or -o json |
| Timestamps per utterance | -o json (utterance list with time_begin, time_end) |
| Full API payload | -o json-full |
| Subtitle file | -o srt or -o vtt (add --diarize for speaker labels) |
| Model choice | --model solaria-1 or --model solaria-3 |
You can list all the possible languages compatible with gladia with the command gladia languages.
| Goal | Command |
|---|---|
| Auto-detect | gladia transcribe <source> |
| Constrain detection | --language en,fr,de (does not enable code switching) |
| Code switching | --code-switching (+ optional --language hints) |
For full CLI vs SDK routing, see ./references/cli-vs-sdk.md.
| Feature | CLI | If not in CLI |
|---|---|---|
| Basic transcription | gladia transcribe | — |
| Speaker diarization | --diarize | gladia-audio-intelligence for advanced config |
| Language / code-switch | --language, --code-switching | SDK for advanced language_config |
| Translation, NER, PII, sentiment, audio-to-LLM | No | gladia-audio-intelligence |
| API summarization addon | No | SDK (agent may summarize -o text output informally) |
| Live streaming | No | gladia-live-transcription |
gladia transcribe meeting.wav
gladia transcribe https://example.com/podcast.mp3 -o json
gladia transcribe https://www.youtube.com/watch?v=jNQXAC9IVRw
gladia transcribe call.wav --diarize -o srt
gladia transcribe interview.mp3 --language en,fr --code-switching -v
gladia transcribe podcast.mp3 --model solaria-1 -o json-full
gladia transcribe meeting.wav --gladia-key <API_KEY> # inline key, no env or ~/.gladia needed
--language en,fr as code-switching — it only constrains detection; add --code-switching separately for per-utterance language detection-o json or --diarize; plain text may lack required fieldsgladia installed and wants terminal workflow, run shell commands~/.gladia, or --gladia-keyFor API errors and diagnostics, see gladia-troubleshooting.