Sound effect

audio Queued Runs in the background — you get a link when it is ready.

Any sound you can describe — a door, a crowd, rain on a roof — as a clip you can drop into an edit.

Built for

Transitions and stingers
Ambience under a voiceover
Product demos

How it works

You provide

A description of the sound, and optionally a length (up to 22 seconds) and whether it should loop.

You get back

One MP3 clip.

What this means for you

Up to 22 seconds, or let it pick the natural length.
Seamless loops for backgrounds.
One flat price per effect.

Try it

Use the API

Details

What you can set

Setting	Type and limits	What it means
`loop` optional	yes / no	Make an effect that loops seamlessly.
`text` required	text, 1–500 characters	The sound you want, in plain words (a door creaking open, rain on a tin roof, a crowd cheering).
`duration_seconds` optional	number, 0.5–22	Length of the effect in seconds (0.5–22); chosen from the description when omitted.
`prompt_influence` optional	number, 0–1	How literally to follow the description (0 = loose, 1 = exact); 0.3 when omitted.

What you get back: An audio file (MP3 by default)
Limits: Max input 500 chars
How it runs: Queued — Runs in the background — you get a link when it is ready.
Alias: oneup/sfx

For developers

The same request as an API call, with this capability's example input:

curl -X POST https://api.oneupai.com/v1/queue/submit/oneup/sfx \
  -H "Authorization: Bearer $ONEUP_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "text": "a wooden front door opening slowly, then a soft click as it closes",
  "duration_seconds": 4
}'

Show input schema (JSON)

{
  "type": "object",
  "required": [
    "text"
  ],
  "properties": {
    "loop": {
      "type": "boolean",
      "description": "Make an effect that loops seamlessly."
    },
    "text": {
      "type": "string",
      "maxLength": 500,
      "minLength": 1,
      "description": "The sound you want, in plain words (a door creaking open, rain on a tin roof, a crowd cheering)."
    },
    "duration_seconds": {
      "type": "number",
      "maximum": 22,
      "minimum": 0.5,
      "description": "Length of the effect in seconds (0.5–22); chosen from the description when omitted."
    },
    "prompt_influence": {
      "type": "number",
      "maximum": 1,
      "minimum": 0,
      "description": "How literally to follow the description (0 = loose, 1 = exact); 0.3 when omitted."
    }
  },
  "additionalProperties": false
}

API Docs

Other audio capabilities

Studio voice

Our most natural voice — the one for ad reads, trailers and anything a customer will judge you by.

18 credits

Original song

Describe the style, hand over your lyrics, and get back a finished song you own the rights to use.

6 credits

Narration voice

Turn up to a minute of text into natural narration in a named voice.

9 credits

Transcript for captions

Turn the speech in your audio or video into a word-timed transcript your captions can follow, word by word.

2 credits per started minute of your media