Skip to main content

​
Prerequisites

  • Python 3.10 or higher - The Gradium SDK requires Python 3.10+. Check your version with:
python3 --version

​
Installation

pip install gradium

​
Quick Start

import asyncio
import gradium

async def main():
    client = gradium.client.GradiumClient(api_key="your-api-key")

    result = await client.tts(
        setup={"voice_id": "YTpq7expH9539ERJ", "output_format": "wav"},
        text="Welcome to Gradium! Transform your text into natural-sounding speech in seconds."
    )

    with open("welcome.wav", "wb") as f:
        f.write(result.raw_data)

if __name__ == "__main__":
    asyncio.run(main())

​
Creating a Client

​
Using API Key Directly

import gradium

client = gradium.client.GradiumClient(api_key="gd_your_api_key_here")

​
Using Environment Variable

Set the GRADIUM_API_KEY environment variable: 
export GRADIUM_API_KEY=gd_your_api_key_here
Then create the client without passing the API key: 
client = gradium.client.GradiumClient()