36 lines
1.0 KiB
Markdown
36 lines
1.0 KiB
Markdown
# Voice notes
|
||
|
||
Enable transcription so voice notes become normal text runs.
|
||
|
||
## Enable transcription
|
||
|
||
=== "takopi config"
|
||
|
||
```sh
|
||
takopi config set transports.telegram.voice_transcription true
|
||
takopi config set transports.telegram.voice_transcription_model "gpt-4o-mini-transcribe"
|
||
```
|
||
|
||
=== "toml"
|
||
|
||
```toml
|
||
[transports.telegram]
|
||
voice_transcription = true
|
||
voice_transcription_model = "gpt-4o-mini-transcribe" # optional
|
||
```
|
||
|
||
Set `OPENAI_API_KEY` in your environment (uses OpenAI’s transcription API).
|
||
|
||
To use a local OpenAI-compatible Whisper server, also set `OPENAI_BASE_URL`
|
||
(for example, `http://localhost:8000/v1`) and a dummy `OPENAI_API_KEY` if your server ignores it.
|
||
If your server requires a specific model name, set `voice_transcription_model` (for example, `whisper-1`).
|
||
|
||
## Behavior
|
||
|
||
When you send a voice note, Takopi transcribes it and runs the result as a normal text message.
|
||
If transcription fails, you’ll get an error message and the run is skipped.
|
||
|
||
## Related
|
||
|
||
- [Config reference](../reference/config.md)
|