Skip to main content
POST

Authorizations

Authorization
string
required
All endpoints require authentication using a Bearer TokenGet an API Key:Visit the API Key management page to get your API KeyAdd the following to the request headers when using it:

Body

model
string
default:"suno"
Audio model. Currently pass suno (defaults to suno if omitted).
audio_urls
array
required
An array of 1–4 publicly accessible audio URLs.
version
string
default:"v5.5"
Generation version: v4 / v4.5 / v4.5+ / v4.5-all / v5 / v5.5, affects audio quality and billing; defaults to v5.5 if omitted.
prompt
string
Lyrics / content.
title
string
Title.
tags
string
Style tags.
negative_tags
string
Style tags to exclude.
style_weight
number
Style weight, 0.001.00.
weirdness_constraint
number
Creativity weight, 0.001.00 (alias weirdness).
audio_weight
number
Audio weight, 0.001.00.
vocal_gender
string
Vocal gender: Male / Female.
auto_lyrics
boolean
true=rewrite the provided lyrics creatively.
Getting the result: This endpoint is an async task. After submitting you get a task_id; poll GET /v1/music/tasks/{task_id} at 3–5s intervals until status is completed or failed (music generation typically takes 30–120s; while generating, status is pending and progress goes queued 10 → ready 50 → done 100). On completion take audio_url from data.result.music[]. On failure data.error.message gives the reason and the pre-deducted quota is automatically refunded.

Response

code
integer
Response status code
data
array
Returned data array