elevenlabs

elevenlabs

비공식 elevenlabs.io (11.ai) 음성 합성 클라이언트

이 라이브러리는 어떤 식 으로든 Elevenlab과 관련이 없거나 관련이 없습니다.

이 클라이언트가 도출 한 Elevenlabs의 공식 API 문서는 여기에서 찾을 수 있습니다.

목적

이 Go 클라이언트는 합성 된 음성을 만들고 elevenlabs.io에 tts (텍스트 음성) 요청을 할 수있는 쉬운 인터페이스를 제공합니다.

전제 조건으로서, 당신은 이미 elevenlabs.io의 계정을 가지고 있어야합니다. 계정을 만든 후 여기에서 API 키를 얻을 수 있습니다.

테스트 프로그램

예제를 테스트하기 위해 프로그램을 say 하려면 실행하십시오.

go install github.com/taigrr/elevenlabs/cmd/say@latest

XI_API_KEY 환경 변수를 설정하고 소용돌이를주기 위해 텍스트를 파이프로 파이프하십시오!

예제 코드

텍스트 음성 연설 예

이 라이브러리를 사용하려면 새 클라이언트를 작성하고 TTS 요청을 음성으로 보냅니다. 다음 코드 블록은 스트리밍 엔드 포인트를 사용하여 Say/Espeak 명령을 복제 할 수있는 방법을 보여줍니다. Faiface의 경고음 패키지를 사용하기로 결정했지만 파일을 MP3 온 디스크에 저장할 수도 있습니다.

 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
}

사운드 생성 예

다음 예제는 사운드 생성 API를 사용하여 음향 효과를 생성하는 방법을 보여줍니다.

 package main

import (
        "context"
        "os"

        "github.com/taigrr/elevenlabs/client"
)

func main () {
        ctx := context . Background ()
        // Create a new client with your API key
        client := client . New ( os . Getenv ( "XI_API_KEY" ))

        // Generate a sound effect and save it to a file
        f , err := os . Create ( "footsteps.mp3" )
        if err != nil {
                panic ( err )
        }
        defer f . Close ()

        // Basic usage (using default duration and prompt influence)
        err = client . SoundGenerationWriter ( ctx , f , "footsteps on wooden floor" , 0 , 0 )
        if err != nil {
                panic ( err )
        }

        // Advanced usage with custom duration and prompt influence
        audio , err := client . SoundGeneration (
                ctx ,
                "heavy rain on a tin roof" ,
                5.0 ,    // Set duration to 5 seconds
                0.5 ,    // Set prompt influence to 0.5
        )
        if err != nil {
                panic ( err )
        }
        os . WriteFile ( "rain.mp3" , audio , 0644 )
}