elevenlabs

Documentation

Overview

Package elevenlabs implements engine.Engine for the ElevenLabs TTS API.

TTS uses POST /v1/text-to-speech/{voice_id} with JSON body. Auth: xi-api-key: {key}, env ELEVENLABS_API_KEY. Synchronous — returns audio binary, converted to data URI.

Index

• Constants
• Variables
• func ConfigSchema() []engine.ConfigField
• func DefaultProvider() engine.Provider
• func ModelInfos() []engine.ModelInfo
• func ModelsByCapability() map[string][]string
• type Config
• type Engine
  • func New(cfg Config) *Engine
  • func (e *Engine) Capabilities() engine.Capability
  • func (e *Engine) Execute(ctx context.Context, g workflow.Graph) (engine.Result, error)

Constants

const (
	ModelMultilingualV2  = "eleven_multilingual_v2"
	ModelTurboV25        = "eleven_turbo_v2_5"
	ModelFlashV25        = "eleven_flash_v2_5"
	ModelMultilingualSTS = "eleven_multilingual_sts_v2"
)

Model constants.

Variables

var (
	ErrMissingText  = errors.New("elevenlabs: missing text for TTS (set prompt)")
	ErrMissingVoice = errors.New("elevenlabs: missing voice ID")
)

Functions

func ConfigSchema

func ConfigSchema() []engine.ConfigField

ConfigSchema returns the configuration fields required by the ElevenLabs engine.

func DefaultProvider

func DefaultProvider() engine.Provider

DefaultProvider returns preset engine configurations for elevenlabs.

func ModelInfos

func ModelInfos() []engine.ModelInfo

ModelInfos returns i18n metadata for all ElevenLabs models.

func ModelsByCapability

func ModelsByCapability() map[string][]string

ModelsByCapability returns all known ElevenLabs models grouped by capability.

Types

type Config

type Config struct {
	APIKey     string
	BaseURL    string
	Model      string
	VoiceID    string // Default voice ID if not specified in graph.
	HTTPClient *http.Client
}

Config configures the ElevenLabs engine.

type Engine

type Engine struct {
	// contains filtered or unexported fields
}

Engine implements engine.Engine for ElevenLabs.

func New

func New(cfg Config) *Engine

New creates an ElevenLabs engine instance.

func (*Engine) Capabilities

func (e *Engine) Capabilities() engine.Capability

Capabilities implements engine.Describer.

func (*Engine) Execute

func (e *Engine) Execute(ctx context.Context, g workflow.Graph) (engine.Result, error)

Execute performs TTS via the ElevenLabs API.