---
title: "Sound Effects - Generate from text"
method: POST
path: "/v1/ai/sound-effects"
tags: ["sound-effects"]
---

# Sound Effects - Generate from text

`POST /v1/ai/sound-effects`

## Request

- Base URL: `https://api.magnific.com`
- URL: `https://api.magnific.com/v1/ai/sound-effects`
- Auth: API key in header `x-magnific-api-key`

Create realistic sound effects from text descriptions using AI.

Generate high-quality audio sound effects based on your text prompts. Perfect for video production, game development, podcasts, and multimedia projects.

## Request body

- Request13
  - `text` string, required: The text to convert to sound effects
  - `loop` boolean: Whether to create a sound effect that loops smoothly
  - `duration_seconds` number, required: The duration of the generated audio in seconds
  - `prompt_influence` number: The influence of the prompt on the generated audio. A value between 0 and 1.
  - `webhook_url` string, uri: Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.

## Response `200`

OK - The task exists and the status is returned

- InlineObject4
  - `data` TaskDetail1, required
    - `task_id` string, uuid, required: Task identifier
    - `status` 'CREATED' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED', required: Task status
    - `generated` string[], required

## Other responses

- `400`: Bad Request - The server could not understand the request due to invalid syntax.
- `401`: Unauthorized - The client must authenticate itself to get the requested response.
- `500`: Internal Server Error - The server has encountered a situation it doesn't know how to handle.
- `503`: Service Unavailable

---

[API](https://skmtc.dev/magnific/apis/magnific-api.md) · [All operations](https://skmtc.dev/magnific/apis/magnific-api/llms.txt) · [OpenAPI document](https://skmtc.dev/magnific/apis/magnific-api/revisions/60711fb082c7?raw)