Transform Text to Realistic Speech: Integrate MetaVoice-1B with Cognitive Actions

21 Apr 2025
Transform Text to Realistic Speech: Integrate MetaVoice-1B with Cognitive Actions

In today's digital landscape, the ability to convert text into realistic speech is a valuable asset for developers looking to enhance user experiences. The MetaVoice Cognitive Actions, specifically the Transform Text to Speech Using MetaVoice-1B, empower developers to harness advanced speech synthesis technology. This action utilizes the powerful MetaVoice-1B model, trained on over 100,000 hours of speech data, enabling seamless text-to-speech conversions.

Prerequisites

Before diving into the integration of the MetaVoice Cognitive Actions, ensure you have the following:

  • An API key for the Cognitive Actions platform.
  • Basic knowledge of sending HTTP requests and handling JSON data.

Authentication typically involves passing your API key in the request headers to authorize your access to the Cognitive Actions services.

Cognitive Actions Overview

Transform Text to Speech Using MetaVoice-1B

This action is designed to transform text inputs into high-quality audio outputs, utilizing the capabilities of the MetaVoice-1B model. This makes it an excellent choice for applications that require realistic voice output, such as virtual assistants, audiobooks, and accessibility tools.

Category: Text-to-Speech

Input

The input for this action requires the following fields:

  • text (optional): A string of text to be transformed into speech. If not provided, a default demo text will be used.
  • inputAudio (required): A string representing the URI of the input audio file. This file should be accessible from the provided URL.

Example Input:

{
  "text": "This is a demo of text to speech by MetaVoice-1B, an open-source foundational audio model by MetaVoice.",
  "inputAudio": "https://replicate.delivery/pbxt/KMZ6fyOMKrtwERmDWAJnd5KRy39a86dgloX7SYP5dVTnQXjv/jacob.wav"
}

Output

The output of this action is a URI to the generated speech audio file, which can be played or processed further.

Example Output:

https://assets.cognitiveactions.com/invocations/f6e49f1c-8fd7-4cee-8d7e-308aa2982e2c/99887d37-5226-470f-8f97-90b2bcae4cf9.wav

Conceptual Usage Example (Python)

Here’s how you might call this Cognitive Action using a hypothetical Python script:

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 = "89d84992-d145-4a30-b551-67045e8038a3" # Action ID for Transform Text to Speech Using MetaVoice-1B

# Construct the input payload based on the action's requirements
payload = {
    "text": "This is a demo of text to speech by MetaVoice-1B, an open-source foundational audio model by MetaVoice.",
    "inputAudio": "https://replicate.delivery/pbxt/KMZ6fyOMKrtwERmDWAJnd5KRy39a86dgloX7SYP5dVTnQXjv/jacob.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 YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The action_id corresponds to the specific action you're invoking. The payload is structured according to the input schema requirements, and the endpoint URL is illustrative, showcasing how a request would be made to execute the action.

Conclusion

Integrating the MetaVoice Cognitive Actions into your applications opens up a world of possibilities for creating engaging and accessible experiences. By transforming text into realistic speech, you can enhance user interaction and broaden the usability of your applications. Explore further use cases such as virtual assistants, educational tools, or accessibility features to fully leverage the power of MetaVoice-1B. Happy coding!

← Back to All Articles