Text-to-Speech & Voice Cloning

from abstrakt import AbstraktClient

client = AbstraktClient()

result = client.run("fal-ai/text-to-speech", {
    "input": {
        "text": "Hello! Welcome to Abstrakt, the AI platform for developers.",
        "voice": "alloy"
    }
})

print(f"Audio URL: {result.audio.url}")

# Professional narration
{"voice": "onyx", "text": "Welcome to our quarterly report..."}

# Friendly assistant
{"voice": "nova", "text": "Hi there! How can I help you today?"}

# Storytelling
{"voice": "fable", "text": "Once upon a time, in a land far away..."}

{
    "input": {
        "text": "This is spoken at normal speed",
        "speed": 1.0  # 0.5 to 2.0
    }
}

# Slower for clarity
{"speed": 0.8}

# Faster for efficiency
{"speed": 1.2}

{
    "input": {
        "text": '''
            <speak>
                <p>This is a paragraph with a <break time="500ms"/> pause.</p>
                <p>This word is <emphasis level="strong">emphasized</emphasis>.</p>
            </speak>
        ''',
        "format": "ssml"
    }
}

# Step 1: Upload reference audio
clone_result = client.run("fal-ai/voice-clone", {
    "input": {
        "reference_audio_url": "https://example.com/voice-sample.mp3",
        "name": "custom_voice"
    }
})

voice_id = clone_result.voice_id

# Step 2: Use cloned voice
speech = client.run("fal-ai/text-to-speech", {
    "input": {
        "text": "This is my cloned voice speaking!",
        "voice_id": voice_id
    }
})

async def generate_audiobook(chapters):
    audio_urls = []
    
    for chapter in chapters:
        result = await client.run_async("fal-ai/text-to-speech", {
            "input": {
                "text": chapter["content"],
                "voice": "fable"
            }
        })
        audio_urls.append({
            "title": chapter["title"],
            "url": result.audio.url
        })
    
    return audio_urls

# MP3 (default, smaller files)
{"output_format": "mp3"}

# WAV (higher quality)
{"output_format": "wav"}

# OGG (web optimized)
{"output_format": "ogg"}