Skip to main content
PUT
create.new_instrumental

Body

application/json
idempotency_key
string<uuid>
required

A unique UUID you choose. Send the same key to retry safely; we'll return the original response without doing the work again.

reference
AudioSource · object
required

An audio source to use as a reference for generation.

callback_url
string<uri> | null

Optional HTTPS URL we'll POST the final response to when the operation reaches ready or failed. Polling remains the canonical source of truth; webhooks are a best-effort latency optimisation.

Required string length: 1 - 2048
n_variations
integer
default:1

How many output variations to produce (1-3).

Required range: 1 <= x <= 3
loudness
LoudnessTarget · object | null

Optional. Normalise every output to a target integrated loudness. Leave it out for outputs exactly as produced; send {} for the defaults (-14 LUFS, compression allowed). Normalising costs no extra credits. Each ready output then reports the loudness measured on it. See loudness.

Response

Successful Response

instrumental
Instrumental · object
required