Enhance Text Predictions with ttsds/gptsovits_2 Cognitive Actions

23 Apr 2025
Enhance Text Predictions with ttsds/gptsovits_2 Cognitive Actions

In today's rapidly evolving landscape of natural language processing, the ability to predict text accurately based on context is invaluable. The ttsds/gptsovits_2 API provides a set of Cognitive Actions designed to enhance text predictions through advanced predictive analysis. Specifically, it allows developers to utilize a speaker's audio reference to improve the interpretation of text input, ensuring more contextual and nuanced predictions. This article will guide you through the available action and how to implement it in your applications effectively.

Prerequisites

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

  • An API key for accessing the Cognitive Actions platform.
  • Basic knowledge of JSON and how to make HTTP requests.
  • Familiarity with Python programming for the conceptual examples.

For authentication, you will typically pass your API key in the request headers when making calls to the Cognitive Actions endpoint.

Cognitive Actions Overview

Execute Text Prediction with Speaker Reference

Description:
This action performs predictive analysis on a given text by considering specific language settings and a speaker's audio reference. By including the audio URI of a speaker, the action aims to enhance the accuracy of text predictions through contextual understanding.

Category: text-processing

Input

The input for this action requires the following fields:

  • text (string, required): The primary text content to be analyzed.
  • language (string, required): The language code of the text, which can be en, zh, ja, ko, or yue.
  • textReference (string, required): An additional text context or excerpt relevant to the primary text.
  • speakerReference (string, required): A URI pointing to an audio file that represents the speaker's voice.

Example Input:

{
  "text": "With tenure, Suzie'd have all the more leisure for yachting, but her publications are no good.",
  "language": "en",
  "textReference": "and keeping eternity before the eyes, though much.",
  "speakerReference": "https://replicate.delivery/pbxt/MNDu8UJR7zB1dZHG3UOPCD5B4crZunv2j32UsTd3Qd5PdG1R/example.wav"
}

Output

The output of this action is a URI pointing to the generated audio file based on the predictive analysis performed on the input text.

Example Output:

https://assets.cognitiveactions.com/invocations/d3a83c45-1c19-4b60-a099-3395b35b9a48/47e2aa1a-bfe5-4711-82ca-3b14d8322252.wav

Conceptual Usage Example (Python)

Here’s how you might call the Execute Text Prediction with Speaker Reference action using 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 = "72aa5a08-4355-4de9-942f-bb53d7448605"  # Action ID for Execute Text Prediction with Speaker Reference

# 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.",
    "language": "en",
    "textReference": "and keeping eternity before the eyes, though much.",
    "speakerReference": "https://replicate.delivery/pbxt/MNDu8UJR7zB1dZHG3UOPCD5B4crZunv2j32UsTd3Qd5PdG1R/example.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, you replace the YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The input payload is structured according to the requirements of the action, and the request is sent to the hypothetical Cognitive Actions endpoint.

Conclusion

The ttsds/gptsovits_2 Cognitive Actions enable developers to enhance text predictions by leveraging contextual audio references. By integrating the Execute Text Prediction with Speaker Reference action into your applications, you can deliver more accurate and contextually relevant text outputs. As you explore the capabilities of this API further, consider various use cases such as chatbots, content generation, and voice applications that can benefit from improved text prediction accuracy. Happy coding!

← Back to All Articles