text-to-speech

Transform Text into Speech Effortlessly with Oute TTS

26 Apr 2025
Transform Text into Speech Effortlessly with Oute TTS

In today's digital landscape, the demand for accessible and interactive content is ever-increasing. Oute TTS (Text-to-Speech) provides developers with a powerful tool to convert written text into natural-sounding speech. By utilizing the OuteTTS 500M model, this service supports a variety of voice options across multiple languages, allowing for a more engaging user experience. Whether you're building an application for accessibility, creating educational tools, or enhancing interactive media, Oute TTS simplifies the process of integrating speech capabilities into your projects.

Prerequisites

To get started with Oute TTS, you will need an API key for the Cognitive Actions service and a basic understanding of making API calls.

Deploy OuteTTS Text-to-Speech

The "Deploy OuteTTS Text-to-Speech" action is designed to facilitate the conversion of text into speech, providing users with a versatile solution for voice synthesis. This action addresses the need for effective communication through audio, whether it's for applications, websites, or devices that require spoken output.

Input Requirements

To use this action, you must provide the following input:

  • inputText: The text you want to convert into speech. This is a required field. For example, "Hello, world."
  • audioSpeaker: Optionally specify the voice for the text-to-speech output. You can choose from a variety of voices, such as "en_male_1" or "fr_female_1". The default setting is "en_male_1".

Expected Output

Upon successfully processing your request, the output will be a URL link to the generated audio file. For example, it might look like this: https://assets.cognitiveactions.com/invocations/45a1bfc1-3fd5-4a9b-9dd0-54d6ea306a02/982e3fa5-db71-4276-bbe4-a3d9d3c0aabf.wav.

Use Cases for this Specific Action

  • Accessibility: Enhance applications for users with visual impairments by providing audio content that reads text aloud.
  • E-Learning: Create engaging educational content that speaks to learners, making it easier to comprehend and retain information.
  • Voice Assistants: Integrate speech capabilities into virtual assistants or chatbots, allowing for a more interactive user experience.
  • Multilingual Support: Cater to a global audience by offering voice synthesis in various languages, improving user engagement and satisfaction.
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 = "e528a9e9-870f-4712-85ad-2d84b0c8c8fd" # Action ID for: Deploy OuteTTS Text-to-Speech

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "inputText": "Hello, world.",
  "audioSpeaker": "en_male_1"
}

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

Oute TTS empowers developers to add text-to-speech functionality to their applications with minimal effort. By providing a straightforward API for converting text into natural-sounding speech, it opens up a world of possibilities for enhancing user interaction and accessibility. Whether you are developing for education, accessibility, or entertainment, integrating Oute TTS can significantly improve the user experience. Start exploring its capabilities today and transform how your users interact with your content!

← Back to All Articles