> ## Documentation Index
> Fetch the complete documentation index at: https://praison.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Audio CLI

> Transcribe audio and generate speech from the command line

Discover audio endpoints and drive transcription and speech through MCP tools or the Python API.

## Discover Audio Endpoints

List every registered audio endpoint with the `audio` tag filter.

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai endpoints list --tags audio
```

## MCP Tools

The audio capability is surfaced as two MCP tools.

```text theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai.audio.transcribe(file_path, model="whisper-1", language=None) -> str
praisonai.audio.speech(text, model="tts-1", voice="alloy") -> str
```

`praisonai.audio.transcribe` returns the transcript text. `praisonai.audio.speech` converts text to audio.

## No Dedicated CLI Verb

There is no top-level `praisonai audio` or `praisonai transcribe` subcommand. Use the Python API or the MCP tools above.

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonai.capabilities import transcribe, speech

transcript = transcribe("./meeting.mp3")
print(transcript.text)

audio = speech("Hello, world!", voice="nova")
audio.save("hello.mp3")
```

## Environment Variables

Set the API key for whichever provider your `model` targets.

| Variable             | Provider             |
| -------------------- | -------------------- |
| `OPENAI_API_KEY`     | OpenAI Whisper / TTS |
| `DEEPGRAM_API_KEY`   | Deepgram             |
| `ELEVENLABS_API_KEY` | ElevenLabs           |

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
export OPENAI_API_KEY=...
praisonai endpoints list --tags audio
```

## Related

<CardGroup cols={2}>
  <Card title="Audio (Python)" icon="waveform-lines" href="/docs/capabilities/audio">
    Full Python usage for transcribe and speech
  </Card>

  <Card title="Endpoints CLI" icon="terminal" href="/docs/cli/endpoints">
    Explore all registered endpoints
  </Card>
</CardGroup>