> ## Documentation Index
> Fetch the complete documentation index at: https://docs.destined.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Python SDK

> Official Python SDK for Destined Voice API (Coming Soon)

## Status

<Warning>
  The Python SDK is currently in development. Expected release: Q1 2025.
</Warning>

## Preview

The Python SDK will provide the same functionality as the TypeScript SDK:

```python theme={null}
from destined_voice import DestinedVoice

client = DestinedVoice(api_key="your-api-key")

# List speakers
speakers = client.speakers.list(
    gender="Female",
    limit=10
)

# Generate speech
audio = client.tts.synthesize(
    speaker_id=speakers[0].id,
    text="Hello from Destined Voice!"
)

print(audio.audio_url)
```

## Features (Planned)

* Full API coverage
* Async support with `asyncio`
* Type hints with Pydantic models
* Automatic retries with exponential backoff
* Streaming support for large audio files

## Get Notified

Sign up to be notified when the Python SDK is released:

<Card title="Join the Waitlist" icon="envelope" href="https://destined.ai/sdk-waitlist">
  Get early access to the Python SDK
</Card>

## Alternative: Direct API

Until the SDK is available, use the API directly:

```python theme={null}
import requests

API_KEY = "your-api-key"
BASE_URL = "https://api.destined.ai"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

# List speakers
response = requests.get(
    f"{BASE_URL}/v1/speakers",
    headers=headers,
    params={"gender": "Female", "limit": 10}
)
speakers = response.json()

# Generate speech
response = requests.post(
    f"{BASE_URL}/v1/tts/synthesize",
    headers=headers,
    json={
        "speaker_id": speakers[0]["id"],
        "text": "Hello from Destined Voice!"
    }
)
result = response.json()
print(result["audio_url"])
```