|
| 1 | +--- |
| 2 | +title: Murf |
| 3 | +slug: /bundles-murf |
| 4 | +--- |
| 5 | + |
| 6 | +import Icon from "@site/src/components/icon"; |
| 7 | +import PartialParams from '@site/docs/_partial-hidden-params.mdx'; |
| 8 | +import PartialConditionalParams from '@site/docs/_partial-conditional-params.mdx'; |
| 9 | + |
| 10 | +<Icon name="Blocks" aria-hidden="true" /> [**Bundles**](/components-bundle-components) contain custom components that support specific third-party integrations with Langflow. |
| 11 | + |
| 12 | +This page describes the components that are available in the **Murf** bundle. |
| 13 | + |
| 14 | +## Set up Murf AI |
| 15 | + |
| 16 | +To use Murf components in Langflow, you first need an API key. |
| 17 | + |
| 18 | +### Generate an API Key |
| 19 | + |
| 20 | +Go to the [Murf API Dashboard](https://murf.ai/api/dashboard?utm_source=langflow-docs) and sign up for an account. |
| 21 | + |
| 22 | +For more information about Murf API authentication and usage, see the [Murf API documentation](https://murf.ai/api/docs/introduction/overview). |
| 23 | + |
| 24 | +## Murf Text to Speech |
| 25 | + |
| 26 | +The **Murf Text to Speech** component lets you generate speech from text input. It provides high-quality voice synthesis with support for multiple voices, languages, and audio formats. |
| 27 | + |
| 28 | +### Features |
| 29 | + |
| 30 | +- **Multiple Voice Options**: Access to a wide variety of voices with different genders, accents, and styles |
| 31 | +- **Multi-language Support**: Support for multiple locales and languages |
| 32 | +- **Audio Customization**: Adjustable speed, pitch, and sample rate |
| 33 | +- **Multiple Output Formats**: Support for MP3, WAV, FLAC, and other audio formats |
| 34 | + |
| 35 | +### Murf Text to Speech Parameters |
| 36 | + |
| 37 | +You can inspect the component's parameters to learn more about the inputs it accepts, the features it supports, and how to configure it. |
| 38 | + |
| 39 | +<PartialParams /> |
| 40 | + |
| 41 | +<PartialConditionalParams /> |
| 42 | + |
| 43 | +For information about accepted values and functionality, see the [Murf API documentation](https://murf.ai/api/docs/api-reference/text-to-speech/generate) or inspect [component code](/concepts-components#component-code). |
| 44 | + |
| 45 | +| Name | Type | Description | |
| 46 | +|------|------|-------------| |
| 47 | +| text | String | Input parameter. The text to convert to speech. Required. | |
| 48 | +| api_key | SecretString | Input parameter. Your Murf API key. Required. | |
| 49 | +| voice_id | String | Input parameter. The ID of the voice to use for speech synthesis. Dynamically populated based on available voices. | |
| 50 | +| locale | String | Input parameter. The locale/language for the voice. Dynamically populated based on selected voice. | |
| 51 | +| channel_type | String | Input parameter. Audio channel configuration. Options: "Mono", "Stereo". Default: "Mono". Advanced. | |
| 52 | +| format | String | Input parameter. Output audio format. Options: "mp3", "wav", "flac", "alaw", "ulaw", "pcm", "ogg". Default: "mp3". Advanced. | |
| 53 | +| rate | Integer | Input parameter. Speech speed adjustment. Range: -50 to 50. Default: 0. Advanced. | |
| 54 | +| pitch | Integer | Input parameter. Voice pitch adjustment. Range: -50 to 50. Default: 0. Advanced. | |
| 55 | +| sample_rate | String | Input parameter. Audio sample rate. Options: "8000", "24000", "44100", "48000". Default: "44100". Advanced. | |
| 56 | + |
| 57 | +### Outputs |
| 58 | + |
| 59 | +The Murf Text to Speech component provides three different output methods: |
| 60 | + |
| 61 | +| Output Name | Type | Description | |
| 62 | +|-------------|------|-------------| |
| 63 | +| response | Data | Returns the raw API response data | |
| 64 | + |
| 65 | +### Usage Examples |
| 66 | + |
| 67 | +#### Basic Text to Speech |
| 68 | +1. Add the Murf Text to Speech component to your flow |
| 69 | +2. Enter your Murf API key |
| 70 | +3. Input the text you want to convert to speech |
| 71 | +4. Select a voice from the dynamically populated list |
| 72 | +5. Choose your preferred locale |
| 73 | +6. Connect the `response` output to display the result |
| 74 | + |
| 75 | +#### Advanced Audio Customization |
| 76 | +For more control over the audio output: |
| 77 | +1. Enable advanced parameters |
| 78 | +2. Adjust the speed (rate) and pitch sliders |
| 79 | +3. Select a different audio format (e.g., WAV for higher quality) |
| 80 | +4. Choose between Mono or Stereo channel configuration |
| 81 | +5. Set the appropriate sample rate for your use case |
| 82 | + |
| 83 | +### Troubleshooting |
| 84 | + |
| 85 | +- **API Key Issues**: Ensure your API key is valid and has sufficient credits |
| 86 | +- **Voice Loading**: If voices don't load, check your internet connection and API key validity |
| 87 | +- **Audio Generation**: For large texts, consider breaking them into smaller chunks |
| 88 | +- **Format Compatibility**: Ensure your target system supports the chosen audio format |
0 commit comments