# Text To Speech — ElevenLabs

> Retrieve an audio file. See the documentation

- Key: `elevenlabs-text-to-speech`
- Type: Action (Read-only)
- Version: 0.0.6
- App: ElevenLabs (`elevenlabs`) — https://pipedream.com/apps/elevenlabs.md
- This page (HTML): https://pipedream.com/apps/elevenlabs/actions/text-to-speech
- Hints: read-only · open-world
- Source: https://github.com/PipedreamHQ/pipedream/blob/master/components/elevenlabs/actions/text-to-speech/text-to-speech.mjs

## Description

Retrieve an audio file. [See the documentation](https://docs.elevenlabs.io/api-reference/text-to-speech)

## Props

| Prop | Type | Required | Description |
|---|---|---|---|
| `voiceId` | `string` | Yes | Identifier of the voice that will be used. Options are loaded from the connected account. |
| `modelId` | `string` | No | Identifier of the model that will be used. Default: eleven_monolingual_v1 Options are loaded from the connected account. |
| `text` | `string` | Yes | The text that will get converted into speech. |
| `similarityBoost` | `string` | No | Low values are recommended if background artifacts are present in generated speech. High enhancement boosts overall voice clarity and target speaker similarity. Very high values can cause artifacts, so adjusting this setting to find the optimal value is encouraged. It goes from 0.0 to 1.0. |
| `stability` | `string` | No | Decreasing stability can make speech more expressive with output varying between re-generations. It can also lead to instabilities. Increasing stability will make the voice more consistent between re-generations, but it can also make it sounds a bit monotone. On longer text fragments we recommend lowering this value. It goes from 0.0 to 1.0. |
| `syncDir` | `dir` | Yes | SyncDir |

## Run it

**MCP**

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "elevenlabs",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// listTools() hands your model this tool's input schema, so it can
// fill the arguments itself:
const result = await mcp.callTool({
  name: "elevenlabs-text-to-speech",
  arguments: {
    voiceId: "Voice ID",
    modelId: "Model ID",
  },
})
```

**TypeScript**

```ts
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "elevenlabs-text-to-speech",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    elevenlabs: { authProvisionId: "apn_xxxxxxx" },
    voiceId: "Voice ID",
    modelId: "Model ID",
  },
})

console.log(result)
```

**cURL**

```bash
curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
  -H "Content-Type: application/json" \
  -H "X-PD-Environment: production" \
  -H "Authorization: Bearer {access_token}" \
  -d '{
    "external_user_id": "{external_user_id}",
    "id": "elevenlabs-text-to-speech",
    "configured_props": {
      "elevenlabs": { "authProvisionId": "apn_xxxxxxx" },
      "voiceId": "Voice ID",
      "modelId": "Model ID"
    }
  }'
```

---

- App: https://pipedream.com/apps/elevenlabs.md · All apps: https://pipedream.com/apps