Skip to main content

​
Status

The Python SDK is currently in development. Expected release: Q1 2025.

​
Preview

The Python SDK will provide the same functionality as the TypeScript SDK: 
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:

Join the Waitlist

Get early access to the Python SDK

​
Alternative: Direct API

Until the SDK is available, use the API directly: 
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"])