> ## 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](https://docs.budgetpixel.com/api-reference/sound-effects/generate-sound-effect-with-sonilo-sfx.md) `sonilo-sfx` | Sonilo | Foley, ambience, UI sounds, transitions, impacts and action effects from a short description, 1-180 seconds long. |
| [Sonilo Video SFX](https://docs.budgetpixel.com/api-reference/sound-effects/generate-sound-effect-with-sonilo-video-sfx.md) `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](https://docs.budgetpixel.com/stock-sound-effects.md) 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}`](https://docs.budgetpixel.com/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](https://docs.budgetpixel.com/concepts/async-jobs.md) 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`](https://docs.budgetpixel.com/api-reference/models/list-available-models)
returns current prices, and [`POST /v1/cost`](https://docs.budgetpixel.com/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](https://docs.budgetpixel.com/concepts/pricing-and-credits.md).


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