text-to-speech

Transform Text into Speech Effortlessly with Parlertts Mini

27 Apr 2025
Transform Text into Speech Effortlessly with Parlertts Mini

In today's digital landscape, converting written content into audio format can significantly enhance user engagement and accessibility. The Parlertts Mini 1.1 Fixed service offers powerful Cognitive Actions designed to convert text into natural-sounding speech. With its advanced capabilities, this service not only simplifies the text-to-speech process but also allows for a personalized audio output by integrating optional prompts and speaker reference audio.

Imagine enhancing your applications with voice features for e-learning platforms, audiobooks, or virtual assistants. Developers can leverage this technology to create immersive experiences that cater to diverse audiences, improving the way information is consumed.

Prerequisites

To get started, ensure you have access to the Cognitive Actions API key and a basic understanding of making API calls.

Process Text-to-Speech Prediction

The "Process Text-to-Speech Prediction" action is the cornerstone of the Parlertts Mini service. Its primary purpose is to convert text into speech, providing a seamless way to vocalize written content. This action is especially beneficial for applications requiring audio feedback or content delivery in a more engaging manner.

Input Requirements

The input for this action requires a structured object with the following properties:

  • Text: The main content that needs to be converted into speech. This field is mandatory.
  • Prompt: An optional guide to influence how the text is processed. If not provided, it defaults to an empty string.
  • Text Reference: Additional context or comparison text that can enhance the processing quality.
  • Speaker Reference: A URI pointing to an audio file that serves as a guide for the speaker's voice, helping to maintain voice consistency.

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"
}

Expected Output

The output is a URL that links to the generated audio file containing the spoken version of the provided text.

Example Output:

https://assets.cognitiveactions.com/invocations/1fe8395d-f561-41dd-95e2-2cd6eeb91ac4/cc3a7e52-4775-40c8-a274-8246ca38c967.wav

Use Cases for This Action

  • E-Learning Platforms: Enhance learning experiences by providing audio explanations for written materials, making it easier for users to absorb information.
  • Audiobook Creation: Quickly transform novels or articles into audiobooks, allowing authors and publishers to reach a broader audience.
  • Virtual Assistants: Implement this action in chatbots or virtual assistants to provide spoken responses to user queries, creating a more interactive experience.
import requests
import json

# Replace with your actual Cognitive Actions API key and endpoint
# Ensure your environment securely handles the API key
COGNITIVE_ACTIONS_API_KEY = "YOUR_COGNITIVE_ACTIONS_API_KEY"
# This endpoint URL is hypothetical and should be documented for users
COGNITIVE_ACTIONS_EXECUTE_URL = "https://api.cognitiveactions.com/actions/execute"

action_id = "61fa79b2-612b-4c0c-99b2-9ea73df84810" # Action ID for: Process Text-to-Speech Prediction

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
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",
    # Add any other required headers for the Cognitive Actions API
}

# Prepare the request body for the hypothetical execution endpoint
request_body = {
    "action_id": action_id,
    "inputs": payload
}

print(f"--- Calling Cognitive Action: {action.name or action_id} ---")
print(f"Endpoint: {COGNITIVE_ACTIONS_EXECUTE_URL}")
print(f"Action ID: {action_id}")
print("Payload being sent:")
print(json.dumps(request_body, indent=2))
print("------------------------------------------------")

try:
    response = requests.post(
        COGNITIVE_ACTIONS_EXECUTE_URL,
        headers=headers,
        json=request_body
    )
    response.raise_for_status() # Raise an exception for bad status codes (4xx or 5xx)

    result = response.json()
    print("Action executed successfully. Result:")
    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 (non-JSON): {e.response.text}")
    print("------------------------------------------------")

Conclusion

The Parlertts Mini 1.1 Fixed service provides developers with a robust solution for transforming text into speech. By leveraging its capabilities, you can enhance user engagement, improve accessibility, and create immersive experiences across various applications. Whether you're building e-learning tools, audiobooks, or virtual assistants, this service can streamline the process and deliver high-quality audio outputs. Start integrating these Cognitive Actions into your projects and elevate the way users interact with your content.

← Back to All Articles