> ## Documentation Index
> Fetch the complete documentation index at: https://docs.budgetpixel.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sound Effects API

> Generate sound effects from a text description, or an effects track synced to a video, with Sonilo SFX through the BudgetPixel API.

**Text → sound, video → synced effects.** Foley, ambience, UI sounds, transitions and
impacts from a short description, or a full effects track synced to what happens in a
video. Each model has its own endpoint, `POST /v1/audios/{model}`.

## Models

2 models. Each name opens its API reference with every parameter.

| Model | Maker | What it does |
| - | - | - |
| [Sonilo SFX](/api-reference/sound-effects/generate-sound-effect-with-sonilo-sfx)<br />`sonilo-sfx` | Sonilo | Foley, ambience, UI sounds, transitions, impacts and action effects from a short description, 1-180 seconds long. |
| [Sonilo Video SFX](/api-reference/sound-effects/generate-sound-effect-with-sonilo-video-sfx)<br />`sonilo-video-sfx` | Sonilo | Frame-accurate Foley, ambience, impacts and action sounds synced to the visible events of an input video (up to 6 minutes). |

Need a common sound? Search the free [stock sound effects](/stock-sound-effects) library
first.

## How a request works

1. Send `POST /v1/audios/{model}` with a description or a video. The response returns a
   job `id` right away.
2. Poll [`GET /v1/audios/{job_id}`](/api-reference/audios/get-music-job-status) until
   `status` is `succeeded`. The response then holds the sound's URL; for a video, also the
   video with the effects mixed in.

[Async jobs](/concepts/async-jobs) covers job statuses and errors.

## Pricing

Sound effects are priced per second: of the length you ask for (3 seconds minimum), or of
the video. [`GET /v1/models?type=audio`](/api-reference/models/list-available-models)
returns current prices, and [`POST /v1/cost`](/api-reference/models/estimate-the-cost-of-a-request)
quotes a request before you send it. You pay only for jobs that succeed; see
[Pricing & credits](/concepts/pricing-and-credits).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.