text-to-speech

Enhance User Experience with Text-to-Speech Conversion using Openvoice 2

26 Apr 2025
Enhance User Experience with Text-to-Speech Conversion using Openvoice 2

Openvoice 2 is a powerful service designed to transform written text into spoken audio. With its advanced text-to-speech capabilities, developers can integrate high-quality voice synthesis into their applications, enhancing user engagement and accessibility. This service supports multiple languages, making it an ideal solution for global applications that require diverse language support.

Imagine a scenario where you’re developing an educational app that reads content aloud to students, or a virtual assistant that provides audio responses. Openvoice 2 simplifies these tasks, allowing you to quickly convert text into lifelike speech, thereby improving user experience and making information more accessible.

Prerequisites

To get started with Openvoice 2, you will need a Cognitive Actions API key and a general understanding of how to make API calls.

Perform Text-to-Speech Conversion (OpenVoice)

The Perform Text-to-Speech Conversion (OpenVoice) action allows developers to convert text in various languages into spoken audio, offering enhanced support and high-quality voice synthesis. This action addresses the need for effective auditory communication in applications, making it easier for users to consume content.

Input Requirements

To utilize this action, you need to provide the following inputs:

  • text: The content you want to convert to speech, formatted as a string. Ensure that the text matches the specified language.
  • language: A two-letter language code (e.g., "en" for English, "zh" for Chinese) that indicates the language of the text.
  • speakerReference: A URI that points to an audio file of the speaker’s voice, typically a WAV file.

Example Input:

{
  "text": "With tenure, Suzie'd have all the more leisure for yachting, but her publications are no good.",
  "language": "en",
  "speakerReference": "https://replicate.delivery/pbxt/MNFXdPaUPOwYCZjZM4azsymbzE2TCV2WJXfGpeV2DrFWaSq8/example_en.wav"
}

Expected Output

The output will be a URL link to the generated audio file, which contains the spoken version of the provided text.

Example Output:

https://assets.cognitiveactions.com/invocations/4f996a1a-6fde-4d62-b7f8-412f652b4f8b/c453aaaf-8cc0-4712-ae2b-275e9f450e95.wav

Use Cases for this Specific Action

  • Educational Applications: Create apps that read textbooks or articles aloud, aiding students with learning disabilities or those who prefer auditory learning.
  • Virtual Assistants: Enhance the interactivity of virtual assistants by enabling them to respond to user queries with natural-sounding speech.
  • Accessibility Features: Implement voice output in web applications to assist visually impaired users, making content more universally accessible.

```python
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 = "016b76b4-ca92-4a1c-a22d-6c5224675d9b" # Action ID for: Perform Text-to-Speech Conversion (OpenVoice)

# 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.",
  "language": "en",
  "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
Openvoice 2's text-to-speech conversion capabilities offer developers a robust tool for creating more interactive and accessible applications. By integrating this action, you can enhance user experience, cater to a diverse audience, and ensure that your content is easily consumable in audio format. Explore the potential of Openvoice 2 and take the next steps toward enriching your applications with voice synthesis today!
← Back to All Articles