swarmauri_llm_playht 0.11.0.dev1

Provider-specific Swarmauri import package for PlayHT text-to-speech, voice management, async, and batch audio generation workflows.

Swarmauri PlayHT Voice Generation

swarmauri_llm_playht provides the provider-specific Swarmauri import package for PlayHTModel. Despite the older llm package name, the runtime is a PlayHT text-to-speech and voice-management adapter that synthesizes speech, enumerates available voices, and supports cloned-voice workflows through the PlayHT API.

The adapter targets PlayHT's API under https://api.play.ht/api/v2, supports the repo-tracked model families Play3.0-mini, PlayHT2.0-turbo, PlayHT1.0, and PlayHT2.0, and writes generated audio to a local output file.

Why Use This Package?

• Keep PlayHT-specific imports explicit in Swarmauri applications.
• Generate audio from text through a Swarmauri component instead of hand-writing PlayHT HTTP requests.
• Reuse one adapter for synthesis, cloned-voice discovery, and cloned-voice lifecycle operations.
• Bridge older llms usage to PlayHT’s speech-generation surface while newer TTS package paths continue to evolve.

FAQ

What does swarmauri_llm_playht install?

It installs PlayHTModel under swarmauri.llms.

Is this actually a chat LLM package?

No. The runtime is a PlayHT text-to-speech adapter with voice-management helpers. The package name reflects the older export surface, but the behavior is speech generation rather than text chat.

Which PlayHT model families are supported?

The current allowlist includes Play3.0-mini, PlayHT2.0-turbo, PlayHT1.0, and PlayHT2.0.

What credentials are required?

You need a PlayHT API key and user ID. The runtime expects both api_key and user_id.

Does it support streaming?

No. stream and astream are explicitly unimplemented for PlayHTModel.

Can it manage cloned voices?

Yes. The adapter includes methods to get cloned voices, clone a voice from a file or URL, and delete a cloned voice.

Features

• PlayHTModel for text-to-speech synthesis against the PlayHT API.
• Sync and async speech generation methods that save audio to a local file path.
• Batch and async batch synthesis workflows.
• Prebuilt voice discovery and validation for the selected voice engine.
• Cloned voice management helpers for create, list, and delete operations.
• Compatibility with Python 3.10, 3.11, 3.12, 3.13, and 3.14.

Installation

uv add swarmauri_llm_playht

pip install swarmauri_llm_playht

Usage

Set PLAYHT_API_KEY and PLAYHT_USER_ID in your environment before creating the model.

Text To Speech

import os

from swarmauri_llm_playht import PlayHTModel

tts = PlayHTModel(
    api_key=os.environ["PLAYHT_API_KEY"],
    user_id=os.environ["PLAYHT_USER_ID"],
    name="Play3.0-mini",
    voice="Adolfo",
)

audio_path = tts.predict(
    "Swarmauri turns provider APIs into composable components.",
    audio_path="playht_output.mp3",
)

print(audio_path)

Async Speech Generation

import asyncio
import os

from swarmauri_llm_playht import PlayHTModel


async def main() -> None:
    tts = PlayHTModel(
        api_key=os.environ["PLAYHT_API_KEY"],
        user_id=os.environ["PLAYHT_USER_ID"],
        name="PlayHT2.0-turbo",
        voice="Adolfo",
    )
    output = await tts.apredict("Generate a short spoken greeting.", "greeting.mp3")
    print(output)


# asyncio.run(main())

Voice Management

import os

from swarmauri_llm_playht import PlayHTModel

tts = PlayHTModel(
    api_key=os.environ["PLAYHT_API_KEY"],
    user_id=os.environ["PLAYHT_USER_ID"],
    name="PlayHT2.0",
    voice="Adolfo",
)

voices = tts.get_cloned_voices()
print(voices)

Examples

• Use PlayHTModel when an agent or application needs provider-hosted speech output saved to a local file.
• Use batch methods when one workflow needs multiple spoken outputs in one pass.
• Use cloned voice methods when the application manages a catalog of custom voices in PlayHT.

Related Packages

• swarmauri_llm_openai
• swarmauri_llm_hyperbolic
• swarmauri_llm_whisper
• swarmauri_llm_groq
• swarmauri_llm_perplexity
• swarmauri_llm_mistral

Foundational Swarmauri Packages

• swarmauri
• swarmauri_core
• swarmauri_base
• swarmauri_standard

More Documentation

• LLM provider model and pricing links
• PlayHT API docs
• PlayHT generated API reference

Best Practices

• Keep PLAYHT_API_KEY and PLAYHT_USER_ID in environment variables or a secret manager.
• Validate the selected voice against the chosen PlayHT voice engine before running batch jobs.
• Use explicit output paths so generated audio assets are easy to manage.
• Prefer newer Swarmauri TTS-native imports when available for new projects, since this package preserves an older compatibility surface.

License

Apache-2.0