---
title: "Sound Generation"
method: POST
path: "/v1/sound-generation"
tags: ["sound-generation"]
---

# Sound Generation

`POST /v1/sound-generation`

Turn text into sound effects for your videos, voice-overs or video games using the most advanced sound effects models in the world.

## Query parameters

- `output_format` 'mp3_22050_32' | 'mp3_24000_48' | 'mp3_44100_32' | 'mp3_44100_64' | 'mp3_44100_96' | 'mp3_44100_128' | 'mp3_44100_192' | 'pcm_8000' | 'pcm_16000' | 'pcm_22050' | 'pcm_24000' | 'pcm_32000' | 'pcm_44100' | 'pcm_48000' | 'ulaw_8000' | 'alaw_8000' | 'opus_48000_32' | 'opus_48000_64' | 'opus_48000_96' | 'opus_48000_128' | 'opus_48000_192'

## Headers

- `xi-api-key` string, nullable — Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

## Request body

- BodySoundGenerationV1SoundGenerationPost
  - `text` string, required — The text that will get converted into a sound effect.
  - `loop` boolean — Whether to create a sound effect that loops smoothly. Only available for the 'eleven_text_to_sound_v2 model'.
  - `duration_seconds` number, nullable — The duration of the sound which will be generated in seconds. Must be at least 0.5 and at most 30. If set to None we will guess the optimal duration using the prompt. Defaults to None.
  - `prompt_influence` number, nullable — A higher prompt influence makes your generation follow the prompt more closely while also making generations less variable. Must be a value between 0 and 1. Defaults to 0.3.
  - `model_id` 'eleven_text_to_sound_v2'

## Response `200`

The generated sound effect as an MP3 file

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation.md) · [All operations](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elevenlabs/elevenlabs-api-documentation/revisions/d1075d6a6487/schema)