---
title: "Generate sound effects"
method: POST
path: "/v1/sound_effect"
tags: ["Start generating"]
---

# Generate sound effects

`POST /v1/sound_effect`

This endpoint will start a new task to generate sound effects from a text description.

## Headers

- `X-Runway-Version` '2024-11-06', required

## Request body

- object
  - `promptText` string, required — A text description of the sound effect to generate.
  - `duration` number — The duration of the sound effect in seconds, between 0.5 and 30 seconds. If not provided, the duration will be determined automatically based on the text description.
  - `loop` boolean — Whether the output sound effect should be designed to loop seamlessly.
  - `model` 'eleven_text_to_sound_v2', required

## Response `200`

The task that was created.

- object
  - `id` string, uuid, required — The ID of the task that was created. Use this to retrieve the task later.

## Other responses

- `429` — You have exceeded the rate limit for this endpoint.

## Changes

- **2025-12-04** `6dab1bdab5d3` — 2 info
  - the `model` request property default value `eleven_text_to_sound_v2` was removed
  - added the media type `application/json` for the response with the status `429`
- **2025-12-03** `c2a88516fa0c` — 1 info
  - the `model` request property default value `eleven_text_to_sound_v2` was added
- **2025-12-03** `76b3962cf49e` — 1 info
  - the `model` request property default value `eleven_text_to_sound_v2` was removed
- **2025-11-04** `6902fa9494c5` — 1 info
  - the `model` request property default value `eleven_text_to_sound_v2` was added
- **2025-10-22** `90724848e40f` — 1 breaking, 4 warning, 4 info
  - the request's body type changed from `object` to no type
  - removed the request property `duration`
  - removed the request property `loop`
  - removed the request property `model`
  - …5 more

[Full history](https://skmtc.dev/runwayml/apis/runwayml-api/changes/v1/sound_effect/post.md)

---

[API](https://skmtc.dev/runwayml/apis/runwayml-api.md) · [All operations](https://skmtc.dev/runwayml/apis/runwayml-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/runwayml/runwayml-api/revisions/4ddc8e3d83c8/schema)