text-to-speech

Transform Text to Speech Effortlessly with Chat TTS

25 Apr 2025
Transform Text to Speech Effortlessly with Chat TTS

In today's digital landscape, the ability to convert text into natural-sounding speech can significantly enhance user experiences across various applications. The Chat TTS service provides developers with a powerful tool to synthesize speech from text. This service leverages advanced machine learning techniques to create customizable speech outputs, making it ideal for a wide range of use cases, from creating engaging chatbots to enhancing accessibility for the visually impaired. By integrating Chat TTS into your applications, you can deliver content in a more dynamic and interactive manner, benefiting both your users and your development process.

Prerequisites

To get started with Chat TTS, you'll need a Cognitive Actions API key and a basic understanding of how to make API calls. This will enable you to harness the full potential of the text-to-speech capabilities provided by the service.

Generate Speech with ChatTTS

The Generate Speech with ChatTTS action allows you to synthesize speech from text input, offering customizable voice tones and the ability to incorporate paralinguistic features like laughter and pauses. This action utilizes a pre-trained model that supports multiple voice options and employs advanced sampling techniques to produce high-quality audio output.

Input Requirements

The input for this action requires a JSON object that includes several fields:

  • text: The content to be synthesized into speech. Ensure it adheres to legal and ethical guidelines.
  • topK: The number of highest probability vocabulary tokens to keep for top-k filtering.
  • topP: The cumulative probability threshold for nucleus sampling (top-p).
  • voice: An identifier for selecting a predefined voice for synthesis.
  • prompt: An optional prompt to guide and refine the synthesis of the text.
  • skipRefine: A flag to bypass the text refinement step.
  • customVoice: An identifier for a custom voice option, if desired.
  • temperature: Controls the randomness of predictions by adjusting the sampling scale.

Expected Output

The output of this action will be a JSON object containing:

  • audio_files: An array of audio file objects, each with a filename, audio duration, and inference time.

Use Cases for this Action

  • Chatbots and Virtual Assistants: Enhance the interactive experience of chatbots by providing them with a voice, making conversations more engaging and lifelike.
  • Accessibility Features: Improve accessibility for users with visual impairments by converting written content into speech, ensuring that information is accessible to everyone.
  • Educational Tools: Create educational applications that can read texts aloud, aiding in language learning and comprehension.
  • Content Creation: Generate audio versions of articles, blog posts, or other written content to reach audiences who prefer listening over reading.
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 = "10ca6bcb-d52b-41bb-ac1a-26f5a57b6959" # Action ID for: Generate Speech with ChatTTS

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "text": "chat T T S 是一款强大的对话式文本转语音模型。它有中英混读和多说话人的能力。\nchat T T S 不仅能够生成自然流畅的语音，还能控制[laugh]笑声啊[laugh]，\n停顿啊[uv_break]语气词啊等副语言现象[uv_break]。这个韵律超越了许多开源模型[uv_break]。\n请注意，chat T T S 的使用应遵守法律和伦理准则，避免滥用的安全风险。[uv_break]",
  "topK": 20,
  "topP": 0.7,
  "voice": 2222,
  "prompt": "",
  "skipRefine": 0,
  "customVoice": 0,
  "temperature": 0.3
}

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 Chat TTS service offers developers an efficient and effective way to transform written text into natural-sounding speech. By integrating this powerful capability into your applications, you can enhance user engagement, improve accessibility, and create dynamic content experiences. Whether you're developing chatbots, educational tools, or content creation platforms, Chat TTS is a valuable resource that can elevate your projects. Start exploring the possibilities today and see how text-to-speech technology can revolutionize your applications!

← Back to All Articles