Spaces:
Running
Running
| 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. |