# ElevenLabs (/integrations/elevenlabs)





{/* MANUAL-CONTENT-START:intro */}

[ElevenLabs](https://elevenlabs.io/) generates and transforms audio. Use this integration for text-to-speech, sound effects, speech-to-speech, and audio isolation. You can also list voices and models, inspect or change voice settings, and read account information.

{/* MANUAL-CONTENT-END */}

## Use the block [#usage-instructions]

Convert text to speech, generate sound effects, transform voices, isolate audio, and manage voices, models, and account settings.

## Actions [#actions]

### ElevenLabs TTS [#elevenlabs-tts]

Convert text to speech using ElevenLabs voices

<ReferenceDetails>
  #### Input [#input]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `text` | string | Yes | The text to convert to speech (e.g., "Hello, welcome to our service!") |
  | `voiceId` | string | Yes | The ID of the voice to use (e.g., "21m00Tcm4TlvDq8ikWAM" for Rachel) |
  | `modelId` | string | No | The ID of the model to use (e.g., "eleven\_multilingual\_v2", "eleven\_turbo\_v2"). Defaults to eleven\_monolingual\_v1 |
  | `stability` | number | No | Voice stability setting from 0.0 to 1.0 (e.g., 0.5 for balanced, 0.75 for more stable). Higher values produce more consistent output |
  | `similarityBoost` | number | No | Similarity boost setting from 0.0 to 1.0 (e.g., 0.75 for natural, 1.0 for maximum similarity). Higher values make the voice more similar to the original |
  | `apiKey` | string | Yes | Your ElevenLabs API key |

  #### Output [#output]

  | Parameter | Type | Description |
  | - | - | - |
  | `audioUrl` | string | The URL of the generated audio |
  | `audioFile` | file | The generated audio file |
</ReferenceDetails>

### ElevenLabs Sound Effects [#elevenlabs-sound-effects]

Generate a sound effect from a text prompt using ElevenLabs

<ReferenceDetails>
  #### Input [#input-1]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Your ElevenLabs API key |
  | `text` | string | Yes | The prompt describing the sound effect (e.g., "thunder rumbling in the distance") |
  | `modelId` | string | No | The model to use (defaults to eleven\_text\_to\_sound\_v2) |
  | `durationSeconds` | number | No | Length of the sound in seconds (0.5-30). Omit to auto-determine |
  | `promptInfluence` | number | No | How closely to follow the prompt from 0.0 to 1.0 (default 0.3) |
  | `loop` | boolean | No | Whether to generate a seamlessly looping sound effect (default false) |

  #### Output [#output-1]

  | Parameter | Type | Description |
  | - | - | - |
  | `audioUrl` | string | URL of the generated sound effect |
  | `audioFile` | file | The generated sound effect file |
</ReferenceDetails>

### ElevenLabs Speech to Speech [#elevenlabs-speech-to-speech]

Convert audio into a chosen ElevenLabs voice while preserving content and emotion

<ReferenceDetails>
  #### Input [#input-2]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Your ElevenLabs API key |
  | `voiceId` | string | Yes | The ID of the target voice to convert the audio into |
  | `audioFile` | file | Yes | The source audio file to convert (e.g., MP3, WAV, M4A) |
  | `modelId` | string | No | The model to use (defaults to eleven\_english\_sts\_v2) |
  | `removeBackgroundNoise` | boolean | No | Whether to isolate the voice and remove background noise (default false) |

  #### Output [#output-2]

  | Parameter | Type | Description |
  | - | - | - |
  | `audioUrl` | string | URL of the converted audio |
  | `audioFile` | file | The converted audio file |
</ReferenceDetails>

### ElevenLabs Audio Isolation [#elevenlabs-audio-isolation]

Remove background noise from an audio file, isolating the speech using ElevenLabs

<ReferenceDetails>
  #### Input [#input-3]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Your ElevenLabs API key |
  | `audioFile` | file | Yes | The audio file to isolate speech from (e.g., MP3, WAV, M4A) |

  #### Output [#output-3]

  | Parameter | Type | Description |
  | - | - | - |
  | `audioUrl` | string | URL of the isolated audio |
  | `audioFile` | file | The isolated audio file |
</ReferenceDetails>

### ElevenLabs List Voices [#elevenlabs-list-voices]

List the voices available in your ElevenLabs account

<ReferenceDetails>
  #### Input [#input-4]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Your ElevenLabs API key |
  | `search` | string | No | Search term to filter voices by name, description, labels, or category |
  | `category` | string | No | Filter by category: premade, cloned, generated, or professional |
  | `pageSize` | number | No | Number of voices to return (1-100, default 10) |
  | `nextPageToken` | string | No | Page token from a previous response to fetch the next page of voices |

  #### Output [#output-4]

  | Parameter | Type | Description |
  | - | - | - |
  | `voices` | array | List of voices |
  | ↳ `voiceId` | string | Unique voice identifier |
  | ↳ `name` | string | Voice name |
  | ↳ `category` | string | Voice category |
  | ↳ `description` | string | Voice description |
  | ↳ `labels` | json | Voice labels (accent, gender, age, use case) |
  | ↳ `previewUrl` | string | URL to a preview audio sample |
  | ↳ `settings` | json | Default voice settings |
  | `totalCount` | number | Total number of matching voices |
  | `hasMore` | boolean | Whether more voices are available |
  | `nextPageToken` | string | Token to fetch the next page |
</ReferenceDetails>

### ElevenLabs Get Voice [#elevenlabs-get-voice]

Get metadata and settings for a specific ElevenLabs voice

<ReferenceDetails>
  #### Input [#input-5]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Your ElevenLabs API key |
  | `voiceId` | string | Yes | The ID of the voice to retrieve (e.g., "21m00Tcm4TlvDq8ikWAM") |

  #### Output [#output-5]

  | Parameter | Type | Description |
  | - | - | - |
  | `voiceId` | string | Unique voice identifier |
  | `name` | string | Voice name |
  | `category` | string | Voice category |
  | `description` | string | Voice description |
  | `labels` | json | Voice labels (accent, gender, age, use case) |
  | `previewUrl` | string | URL to a preview audio sample |
  | `settings` | json | Default voice settings |
  | `availableForTiers` | array | Subscription tiers the voice is available on |
  | `highQualityBaseModelIds` | array | Model IDs that support high-quality output for this voice |
  | `isOwner` | boolean | Whether the current user owns this voice |
</ReferenceDetails>

### ElevenLabs Get Voice Settings [#elevenlabs-get-voice-settings]

Get the configured settings for a specific ElevenLabs voice

<ReferenceDetails>
  #### Input [#input-6]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Your ElevenLabs API key |
  | `voiceId` | string | Yes | The ID of the voice whose settings to retrieve |

  #### Output [#output-6]

  | Parameter | Type | Description |
  | - | - | - |
  | `stability` | number | Voice stability (0.0-1.0) |
  | `similarityBoost` | number | Similarity boost (0.0-1.0) |
  | `style` | number | Style exaggeration (0.0-1.0) |
  | `useSpeakerBoost` | boolean | Whether speaker boost is enabled |
  | `speed` | number | Speech speed (1.0 = normal) |
</ReferenceDetails>

### ElevenLabs Edit Voice Settings [#elevenlabs-edit-voice-settings]

Update the settings for a specific ElevenLabs voice

<ReferenceDetails>
  #### Input [#input-7]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Your ElevenLabs API key |
  | `voiceId` | string | Yes | The ID of the voice to update |
  | `stability` | number | No | Voice stability from 0.0 to 1.0 (default 0.5) |
  | `similarityBoost` | number | No | Similarity boost from 0.0 to 1.0 (default 0.75) |
  | `style` | number | No | Style exaggeration from 0.0 to 1.0 (default 0) |
  | `useSpeakerBoost` | boolean | No | Whether to enhance similarity to the original speaker (default true) |
  | `speed` | number | No | Speech speed where 1.0 is normal (default 1.0) |

  #### Output [#output-7]

  | Parameter | Type | Description |
  | - | - | - |
  | `status` | string | Request outcome ("ok" on success) |
</ReferenceDetails>

### ElevenLabs List Models [#elevenlabs-list-models]

List the models available in ElevenLabs

<ReferenceDetails>
  #### Input [#input-8]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Your ElevenLabs API key |

  #### Output [#output-8]

  | Parameter | Type | Description |
  | - | - | - |
  | `models` | array | List of available models |
  | ↳ `modelId` | string | Unique model identifier |
  | ↳ `name` | string | Model name |
  | ↳ `description` | string | Model description |
  | ↳ `canDoTextToSpeech` | boolean | Supports text-to-speech |
  | ↳ `canDoVoiceConversion` | boolean | Supports voice conversion |
  | ↳ `canUseStyle` | boolean | Supports the style parameter |
  | ↳ `canUseSpeakerBoost` | boolean | Supports speaker boost |
  | ↳ `languages` | array | Languages supported by the model |
  | ↳ `languageId` | string | Language code |
  | ↳ `name` | string | Language name |
</ReferenceDetails>

### ElevenLabs Get User [#elevenlabs-get-user]

Get account and subscription information for the ElevenLabs user

<ReferenceDetails>
  #### Input [#input-9]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Your ElevenLabs API key |

  #### Output [#output-9]

  | Parameter | Type | Description |
  | - | - | - |
  | `userId` | string | Unique user identifier |
  | `isNewUser` | boolean | Whether the user is new |
  | `subscription` | object | Subscription and usage details |
  | ↳ `tier` | string | Subscription tier |
  | ↳ `characterCount` | number | Characters used this period |
  | ↳ `characterLimit` | number | Character quota for this period |
  | ↳ `canExtendCharacterLimit` | boolean | Whether the character limit can be extended |
  | ↳ `status` | string | Subscription status |
  | ↳ `nextCharacterCountResetUnix` | number | Unix timestamp when the character count resets |
</ReferenceDetails>
