Generate Speech Effortlessly with ParlerTTS Mini: A Developer's Guide

24 Apr 2025
Generate Speech Effortlessly with ParlerTTS Mini: A Developer's Guide

In the realm of text-to-speech technology, the ParlerTTS Mini model offers a powerful tool for converting text into spoken words. With its customizable features, developers can enhance user experiences by integrating natural-sounding speech into applications. This blog post will guide you through using the Cognitive Action "Generate Speech with Parler," detailing its functionality and how to implement it in your projects.

Prerequisites

Before diving into the integration, make sure you have the following:

  • An API key for the Cognitive Actions platform to authenticate your requests.
  • Basic knowledge of JSON structure and Python programming.

Authentication typically involves including your API key in the headers of your requests, ensuring secure access to the Cognitive Actions services.

Cognitive Actions Overview

Generate Speech with Parler

The Generate Speech with Parler action is designed to convert text input into speech using the ParlerTTS Mini model. This action allows for voice or style customization through a speaker reference, making it versatile for various applications.

Input

The input for this action requires the following fields:

  • text (required): The primary text content to be converted to speech.
  • prompt (optional): Additional instructions or context for the text.
  • textReference (optional): A supplementary text string providing further context or reference.
  • speakerReference (optional): A URI pointing to an audio file that serves as a reference for the speaker's voice or style.

Here’s an example input JSON payload:

{
  "text": "With tenure, Suzie'd have all the more leisure for yachting, but her publications are no good.",
  "prompt": " ",
  "textReference": "and keeping eternity before the eyes, though much.",
  "speakerReference": "https://replicate.delivery/pbxt/MNFXdPaUPOwYCZjZM4azsymbzE2TCV2WJXfGpeV2DrFWaSq8/example_en.wav"
}

Output

Upon successful execution, the action returns a URL pointing to the generated audio file. This file contains the synthesized speech from the provided text. Here’s an example of what the output might look like:

https://assets.cognitiveactions.com/invocations/f495ce63-b364-4914-8276-11e08144c69e/e25be636-7973-40c6-975a-2b7a009209c0.wav

Conceptual Usage Example (Python)

To illustrate how to use the "Generate Speech with Parler" action, here’s a Python code snippet that demonstrates constructing the request:

import requests
import json

# Replace with your Cognitive Actions API key and endpoint
COGNITIVE_ACTIONS_API_KEY = "YOUR_COGNITIVE_ACTIONS_API_KEY"
COGNITIVE_ACTIONS_EXECUTE_URL = "https://api.cognitiveactions.com/actions/execute" # Hypothetical endpoint

action_id = "3a4b7ef5-4654-4777-84ba-e99fbfca1e55" # Action ID for Generate Speech with Parler

# Construct the input payload based on the action's requirements
payload = {
    "text": "With tenure, Suzie'd have all the more leisure for yachting, but her publications are no good.",
    "prompt": " ",
    "textReference": "and keeping eternity before the eyes, though much.",
    "speakerReference": "https://replicate.delivery/pbxt/MNFXdPaUPOwYCZjZM4azsymbzE2TCV2WJXfGpeV2DrFWaSq8/example_en.wav"
}

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

try:
    response = requests.post(
        COGNITIVE_ACTIONS_EXECUTE_URL,
        headers=headers,
        json={"action_id": action_id, "inputs": payload} # Hypothetical structure
    )
    response.raise_for_status() # Raise an exception for bad status codes (4xx or 5xx)

    result = response.json()
    print("Action executed successfully:")
    print(json.dumps(result, indent=2))

except requests.exceptions.RequestException as e:
    print(f"Error executing action {action_id}: {e}")
    if e.response is not None:
        print(f"Response status: {e.response.status_code}")
        try:
            print(f"Response body: {e.response.json()}")
        except json.JSONDecodeError:
            print(f"Response body: {e.response.text}")

In this code snippet, replace the placeholder with your actual API key and endpoint. The action ID and input payload are structured according to the requirements of the Generate Speech with Parler action, ensuring a smooth execution.

Conclusion

The Generate Speech with Parler action opens up new avenues for creating engaging and interactive applications. By integrating this powerful text-to-speech capability, developers can enhance user experiences, making content more accessible and captivating.

Consider exploring various use cases, such as creating audiobooks, enhancing virtual assistants, or adding voiceovers to multimedia content. With the right implementation, the possibilities are endless!

← Back to All Articles