Create Speech

client.audio.speech.create(
    input: str,
    model: Union[str, Literal["tts-1", "tts-1-hd", "gpt-4o-mini-tts", "gpt-4o-mini-tts-2025-12-15"]],
    voice: Union[str, Literal["alloy", "ash", "ballad", "coral", "echo", "sage", "shimmer", "verse", "marin", "cedar"], dict],
    instructions: Optional[str] = None,
    response_format: Optional[Literal["mp3", "opus", "aac", "flac", "wav", "pcm"]] = None,
    speed: Optional[float] = None,
    stream_format: Optional[Literal["sse", "audio"]] = None
) -> BinaryAPIResponse

from dedalus_labs import DedalusLabs
from pathlib import Path

client = DedalusLabs()

# Generate speech and save to file
response = client.audio.speech.create(
    input="Hello! Welcome to our text-to-speech demo.",
    model="tts-1",
    voice="alloy"
)

with open("output.mp3", "wb") as f:
    f.write(response.content)

# Generate high-quality speech with custom speed
response = client.audio.speech.create(
    input="This is a test of the high definition text-to-speech system.",
    model="tts-1-hd",
    voice="nova",
    speed=1.2,
    response_format="wav"
)

Path("output.wav").write_bytes(response.content)

# Use advanced model with instructions
response = client.audio.speech.create(
    input="I'm excited to announce our new product launch!",
    model="gpt-4o-mini-tts",
    voice="shimmer",
    instructions="Speak with enthusiasm and energy",
    response_format="opus"
)

with open("announcement.opus", "wb") as f:
    f.write(response.content)

# Using a custom voice
response = client.audio.speech.create(
    input="Custom voice demonstration",
    model="gpt-4o-mini-tts-2025-12-15",
    voice={"id": "voice_abc123"},
    speed=0.9
)

Path("custom_voice.mp3").write_bytes(response.content)