---
name: bijection-elevenlabs
description: "Evaluate and integrate the Elevenlabs component with Bijection."
---

# Elevenlabs

Speech transcription

- Package: @bijectionhq/elevenlabs
- Category: Media
- Status: Preview
- License: Apache-2.0
- Bijection source (repository access required): https://github.com/bijectionhq/elevenlabs/tree/82ff2c0fd847388afa02620e83de9ba4fdd81f89
- Upstream: https://github.com/wantpinow/convex-elevenlabs/tree/1f6b16f5e1cc1c9451295451b422e50218936d3b
- Documentation: https://docs.bijection.com/components/using
- Directory: https://bijection.com/components/elevenlabs

## Get the source

Bijection repository access is required. Request access at https://bijection.com/contact.

```sh
git clone https://github.com/bijectionhq/elevenlabs.git
cd elevenlabs
git checkout 82ff2c0fd847388afa02620e83de9ba4fdd81f89
```

## Before using this component

Read the package README at the recorded revision for setup, dependencies, and API examples. Upstream documentation describes the original package and may differ from the Bijection adaptation. This is a source candidate for evaluation. Catalog inclusion does not establish npm availability or runtime qualification. Check compatibility with your SDK and deployment before adoption. External providers run their own compute.

## Integration workflow

1. Read the source README and package manifest at the recorded revision.
2. Confirm the required SDK, dependency availability, and runtime compatibility.
3. Follow the component's documented setup and configuration. Never invent an npm install command from a catalog package name.
4. Keep credentials in the project's existing secret store.
5. Follow the project's execution rules for verification and report what was actually checked.

## Original upstream skill

The following guidance describes convex-elevenlabs. Its installation commands and APIs refer to the upstream package. Evaluate compatibility with the Bijection source separately.


# convex-elevenlabs

## Instructions

Use convex-elevenlabs to integrate elevenlabs text-to-speech api with convex backend functions for seamless voice synthesis in web applications. This Convex component integrates directly with your backend.

### Installation

```bash
npm install convex-elevenlabs
```

### Capabilities

- Generate speech from text directly in Convex mutations and actions
- Handle audio file storage and retrieval with built-in Convex integration
- Reduce boilerplate code for ElevenLabs API authentication and requests
- Stream audio responses efficiently through Convex's infrastructure

## Examples

### how to add text to speech to Convex app

Use convex-elevenlabs to call ElevenLabs API from Convex actions and store generated audio files. The component handles API authentication and provides helper functions for voice synthesis that integrate with Convex's file storage system.

### generate speech from user messages in Convex

Import convex-elevenlabs functions in your Convex mutations to convert user text to speech audio files. The component processes text input through ElevenLabs voices and returns audio URLs accessible through Convex queries.

### voice synthesis backend integration Convex

convex-elevenlabs provides server-side voice generation by wrapping ElevenLabs API calls within Convex actions. This enables voice synthesis triggered by database changes or user interactions without client-side API exposure.

## When NOT to use

- When a simpler built-in solution exists for your specific use case
- If you are not using Convex as your backend
- When the functionality provided by convex-elevenlabs is not needed

## Troubleshooting

**Does convex-elevenlabs require an ElevenLabs API key?**

Yes, convex-elevenlabs requires a valid ElevenLabs API key to function. You'll need to set up your API credentials in Convex environment variables to authenticate requests to ElevenLabs voice synthesis services.

**Can convex-elevenlabs handle multiple voice models?**

convex-elevenlabs supports different ElevenLabs voice models and voices available through the ElevenLabs API. You can specify voice parameters when calling synthesis functions to use different voice characteristics and models.

**How does convex-elevenlabs store generated audio files?**

convex-elevenlabs integrates with Convex's built-in file storage system to save generated audio files. The component handles the upload process and returns file URLs that can be accessed through standard Convex file queries.

**What audio formats does convex-elevenlabs support?**

convex-elevenlabs supports the audio formats provided by ElevenLabs API, typically including MP3 and other common audio formats. The specific formats depend on ElevenLabs API capabilities and can be configured through the component's options.

## Resources

- [npm package](https://www.npmjs.com/package/convex-elevenlabs)
- [GitHub repository](https://github.com/wantpinow/convex-elevenlabs)
- [Convex Components Directory](https://www.convex.dev/components/convex-elevenlabs)
- [Convex documentation](https://docs.convex.dev)