README.md

metadata

title: Dialogue TTS
emoji: 🗣️🎙️
colorFrom: blue
colorTo: green
sdk: gradio
app_file: app.py
pinned: false

Dialogue Script to Speech Synthesis

This Hugging Face Space converts dialogue scripts into speech using OpenAI's TTS models (tts-1, tts-1-hd, gpt-4o-mini-tts).

Features

• Input Script: Provide a dialogue script with lines in the format [Speaker] Utterance.
• TTS Models: Choose from tts-1, tts-1-hd, or gpt-4o-mini-tts.
• Voice Configuration:
  • Single Global Voice: Use one voice for all speakers.
  • Random per Speaker: Assigns a unique random voice to each speaker consistently within a run.
  • A/B Round Robin: Cycles through available voices for each unique speaker.
  • Detailed Per-Speaker UI: Configure voice, speed (for tts-1/hd), and emotional vibe/custom instructions (for gpt-4o-mini-tts) for each speaker individually.
• Output:
  • A ZIP file containing individual MP3s for each line.
  • A single merged MP3 of the entire dialogue with custom pauses.
• Cost Estimation: Displays an estimated cost before generating audio.
• NSFW Check: Optional content safety check using an external API (if NSFW_API_URL_TEMPLATE is configured).

How to Use

1. Enter your dialogue script in the text area. Example:

   [Alice] Hello Bob, how are you today?
   [Bob] I'm doing great, Alice! Thanks for asking.
   [Narrator] And so their conversation began.
   

2. Select the TTS Model.
3. Set the pause duration (in milliseconds) between lines for the merged audio.
4. Choose a Speaker Configuration Method:
   • If "Single Voice (Global)", select the voice.
   • If "Detailed Configuration...", click "Load/Refresh Per-Speaker Settings UI" and adjust settings for each speaker.
   • Other methods will apply voices automatically.
5. (Optional) Adjust Global Speed or Global Instructions if applicable to your chosen model and configuration.
6. Click "Calculate Cost" to see an estimate.
7. Click "Generate Audio".
8. Download the ZIP file or listen to/download the merged MP3.

Secrets

This Space requires the following secrets to be set in the Hugging Face Space settings:

• OPENAI_API_KEY: Your OpenAI API key.
• NSFW_API_URL_TEMPLATE (Optional): URL template for NSFW checking, e.g., https://api.example.com/check?text={text}. The placeholder {text} will be URL-encoded.
• MODEL_DEFAULT (Optional): Default TTS model (e.g., tts-1-hd).

Smoke Test Script

Use the following script to test basic functionality: [Gandalf] You shall not pass! [Frodo] I will take the Ring to Mordor. [Gandalf] So be it.

Choose your desired model and settings (e.g., "Random per Speaker"), then generate.

Deployment

This application is designed to be deployed as a Hugging Face Space. Ensure ffmpeg is available (handled by container.yaml for Classic Spaces). Set the necessary secrets in your Space settings on Hugging Face Hub.