Skip to main content
POST

Authorizations

Authorization
string
header
required

Use your API key from the RawUGC dashboard. Include as: Authorization: Bearer YOUR_API_KEY

Body

application/json
prompt
string
required

Text description of the music to generate. Include genre, mood, instruments, tempo, and style details for best results.

Required string length: 1 - 2000
model
enum<string>
default:V5

Suno model version to use. V5 is the latest and recommended model.

Available options:
V3_5,
V4,
V4_5,
V4_5PLUS,
V4_5ALL,
V5
instrumental
boolean
default:true

Generate instrumental-only music (no vocals). Defaults to true.

title
string

Title for the generated track. When provided along with style, enables custom mode.

Maximum string length: 200
style
string

Music style descriptor for custom mode (e.g., 'lo-fi hip hop', 'epic orchestral'). Used with title for custom mode.

Maximum string length: 500

Response

Music generation initiated successfully

musicId
string

Unique music identifier (mus_xxx format)

model
string

Suno model version used for generation

status
enum<string>

Current generation status

Available options:
pending,
processing,
completed,
failed
creditsUsed
number

Number of credits deducted (3 per generation)

newBalance
number

Remaining credit balance after deduction

estimatedCompletionTime
string

Estimated time until track is ready (human-readable)

createdAt
number

Timestamp when generation was initiated (milliseconds since epoch)