Transform Your Text into Speech with ttsds/parlertts_large_1_0 Cognitive Actions

23 Apr 2025
Transform Your Text into Speech with ttsds/parlertts_large_1_0 Cognitive Actions

In today's digital landscape, the ability to convert text into natural-sounding speech can significantly enhance user experiences across various applications. The ttsds/parlertts_large_1_0 API offers a powerful solution for developers looking to integrate high-quality text-to-speech (TTS) capabilities into their applications. This API features a sophisticated model that not only synthesizes speech from text but also allows for nuanced control through optional prompts and speaker references. In this article, we'll explore how to effectively utilize the Perform Text-to-Speech Conversion action.

Prerequisites

To get started with the ttsds/parlertts_large_1_0 Cognitive Actions, you'll need:

  • An API key for the Cognitive Actions platform.
  • Basic knowledge of JSON and how to make HTTP requests.

Authentication typically involves passing your API key in the request headers. This is essential for securing your API interactions.

Cognitive Actions Overview

Perform Text-to-Speech Conversion

The Perform Text-to-Speech Conversion action transforms text input into high-quality synthesized speech using the Parlertts Large 1.0 model. This action enables developers to create more interactive and engaging applications by synthesizing speech that mimics human intonation and emotion.

Input

The input for this action requires a JSON object that includes the following fields:

  • text (required): The main text input for processing.
  • prompt (optional): An additional prompt that can influence the speech synthesis.
  • textReference (optional): A reference string related to the main text, providing context or citation.
  • speakerReference (optional): A URL pointing to an audio file that serves as a reference for the speaker's voice.

Example Input:

{
  "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, this action returns a URL pointing to the synthesized speech audio file.

Example Output:

https://assets.cognitiveactions.com/invocations/bb6e3f93-79bf-4cf2-8e9c-ebb68302da85/0a29e854-3b70-4753-9345-5149557060ac.wav

Conceptual Usage Example (Python)

Here’s how you might implement the Perform Text-to-Speech Conversion action in Python:

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 = "e5b7304e-1dbd-432f-8d50-92f2cd1f4886"  # Action ID for Perform Text-to-Speech Conversion

# 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 conceptual example, we construct the input payload based on the required schema. The action ID is specified, and the API key is included in the request headers. The endpoint URL used here is illustrative and should be replaced with the actual URL provided by your Cognitive Actions service.

Conclusion

The ttsds/parlertts_large_1_0 Cognitive Actions provide developers with a robust solution for integrating text-to-speech capabilities into their applications. With features like customizable prompts and speaker references, you can enhance the interactivity and realism of your audio outputs. Whether you're developing an accessibility feature or a language learning tool, these Cognitive Actions offer significant potential. Explore further use cases and innovate your applications today!

← Back to All Articles