Skip to main content
POST
Generate music
Creates an asynchronous music generation job.
The public music routes are currently mounted but temporarily disabled, so requests currently return 501 not_implemented.
Poll completion with GET /music/generate/{music_id}.

Request Shape

Suno Options

  • suno.customMode (boolean, default false)
  • suno.instrumental (boolean, default false)
  • suno.prompt (optional override for top-level prompt)
  • suno.style, suno.title (required when customMode = true)
  • suno.personaId, suno.personaModel
  • suno.negativeTags, suno.vocalGender
  • suno.styleWeight, suno.weirdnessConstraint, suno.audioWeight

Validation Rules

  • When customMode = false, prompt is required.
  • When customMode = true, both style and title are required.
  • When customMode = true and instrumental = false, prompt is required.
Validation errors return 400 with:

Response

usage can include output_audio_seconds when duration is provided and pricing is computed against seconds.

Authorizations

Authorization
string
header
required

Bearer token authentication

Body

application/json
model
string
required
prompt
string
duration
integer
format
enum<string>
Available options:
mp3,
wav,
ogg,
aac
provider
object

Provider routing preferences for gateway selection.

suno
object
elevenlabs
object
echo_upstream_request
boolean
debug
object

Gateway debug controls. These flags are never forwarded upstream.

Response

200 - application/json

Music generation response

The response is of type object.

Last modified on July 26, 2026