mirror of
https://github.com/taigrr/elevenlabs.git
synced 2026-04-02 03:08:57 -07:00
c585531fae
* support `style` and `use_speaker_boost` API attrs * support optional command line string as text * print out time it took to run
93 lines
3.3 KiB
Markdown
93 lines
3.3 KiB
Markdown
# elevenlabs
|
|
[](https://opensource.org/licenses/0BSD)
|
|
[](https://godoc.org/github.com/taigrr/elevenlabs)
|
|
[](go.mod)
|
|
[](https://goreportcard.com/report/github.com/taigrr/elevenlabs)
|
|
|
|
|
|
Unofficial [elevenlabs.io](https://beta.elevenlabs.io/) ([11.ai](http://11.ai)) voice synthesis client
|
|
|
|
This library is not affiliated with, nor associated with ElevenLabs in any way.
|
|
|
|
ElevenLabs' official api documentation, upon which this client has been
|
|
derived, [can be found here](https://api.elevenlabs.io/docs).
|
|
|
|
## Purpose
|
|
This go client provides an easy interface to create synthesized voices and
|
|
make TTS (text-to-speech) requests to elevenlabs.io
|
|
|
|
|
|
As a prerequisite, you must already have an account with elevenlabs.io.
|
|
After creating your account, you can get your API key [from here](https://help.elevenlabs.io/hc/en-us/articles/14599447207697-How-to-authorize-yourself-using-your-xi-api-key-).
|
|
|
|
## Test Program
|
|
|
|
To test out an example `say` program, run:
|
|
|
|
`go install github.com/taigrr/elevenlabs/cmd/say@latest`
|
|
|
|
Set the `XI_API_KEY` environment variable, and pipe it some text to give it a whirl!
|
|
|
|
## Example Code
|
|
|
|
To use this library, create a new client and send a TTS request to a voice.
|
|
The following code block illustrates how one might replicate the say/espeak
|
|
command, using the streaming endpoint.
|
|
I've opted to go with faiface's beep package, but you can also save the file
|
|
to an mp3 on-disk.
|
|
```go
|
|
package main
|
|
|
|
import (
|
|
"bufio"
|
|
"context"
|
|
"io"
|
|
"log"
|
|
"os"
|
|
"time"
|
|
|
|
"github.com/faiface/beep"
|
|
"github.com/faiface/beep/mp3"
|
|
"github.com/faiface/beep/speaker"
|
|
|
|
"github.com/taigrr/elevenlabs/client"
|
|
"github.com/taigrr/elevenlabs/client/types"
|
|
)
|
|
|
|
func main() {
|
|
ctx := context.Background()
|
|
// load in an API key to create a client
|
|
client := client.New(os.Getenv("XI_API_KEY"))
|
|
// fetch a list of voice IDs from elevenlabs
|
|
ids, err := client.GetVoiceIDs(ctx)
|
|
if err != nil {
|
|
panic(err)
|
|
}
|
|
// prepare a pipe for streaming audio directly to beep
|
|
pipeReader, pipeWriter := io.Pipe()
|
|
reader := bufio.NewReader(os.Stdin)
|
|
text, _ := reader.ReadString('\n')
|
|
go func() {
|
|
// stream audio from elevenlabs using the first voice we found
|
|
err = client.TTSStream(ctx, pipeWriter, text, ids[0], types.SynthesisOptions{Stability: 0.75, SimilarityBoost: 0.75, Style: 0.0, UseSpeakerBoost: true})
|
|
if err != nil {
|
|
panic(err)
|
|
}
|
|
pipeWriter.Close()
|
|
}()
|
|
// decode and prepare the streaming mp3 as it comes through
|
|
streamer, format, err := mp3.Decode(pipeReader)
|
|
if err != nil {
|
|
log.Fatal(err)
|
|
}
|
|
defer streamer.Close()
|
|
speaker.Init(format.SampleRate, format.SampleRate.N(time.Second/10))
|
|
done := make(chan bool)
|
|
// play the audio
|
|
speaker.Play(beep.Seq(streamer, beep.Callback(func() {
|
|
done <- true
|
|
})))
|
|
<-done
|
|
}
|
|
```
|