cronygen 0.1.0

Official Python SDK for CronyGen Text-to-Speech API

CronyGen Python SDK

Official Python SDK for the CronyGen Text-to-Speech API.

Installation

pip install cronygen

Quick Start

from cronygen import CronyGen

# Initialize client
client = CronyGen(api_key="crony_sk_your_api_key")

# Generate TTS with a default voice
generation = client.tts.generate(
    text="Hello world! This is a test of CronyGen text-to-speech.",
    voice="en-us-aria"
)

# Download the audio
client.tts.download(generation, "output.wav")
print(f"Audio saved! Duration: {generation.output_duration_seconds}s")

Features

• Sync & Async clients - Use CronyGen or AsyncCronyGen
• Default voices - 20+ pre-configured voices across accents
• Automatic polling - Wait for generation completion
• Type hints - Full type annotations for IDE support

Voices

# List default voices
voices = client.voices.list_defaults(gender="female", accent="american")
for voice in voices:
    print(f"{voice.name}: {voice.slug}")

# List your cloned voices (created via dashboard)
my_voices = client.voices.list()
for voice in my_voices.data:
    print(f"{voice.name}: {voice.id} ({voice.status})")

# Use a cloned voice for TTS
generation = client.tts.generate(
    text="This is my cloned voice!",
    voice=my_voices.data[0].id,
    voice_type="cloned"
)

Async Usage

import asyncio
from cronygen import AsyncCronyGen

async def main():
    async with AsyncCronyGen(api_key="crony_sk_your_api_key") as client:
        generation = await client.tts.generate(
            text="Hello async world!",
            voice="en-uk-ronald"
        )
        print(f"Audio URL: {generation.output_audio_url}")

asyncio.run(main())

Error Handling

from cronygen import CronyGen, InsufficientCreditsError, RateLimitError

client = CronyGen(api_key="crony_sk_your_api_key")

try:
    generation = client.tts.generate(text="Hello world!")
except InsufficientCreditsError as e:
    print(f"Not enough credits: {e.available} available, {e.required} required")
except RateLimitError as e:
    print(f"Rate limited. Retry after {e.retry_after} seconds")

Documentation

Full documentation at zingotron.com/docs/sdks/python