Skip to main content
POST
/
music
/
generate
curl --request POST \ --url https://rawugc.com/api/v1/music/generate \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "prompt": "upbeat lo-fi hip hop beat with jazzy piano chords and vinyl crackle", "model": "V5", "instrumental": true } '
{
  "musicId": "mus_jh7a3b9xq2pn4r8k",
  "model": "V5",
  "status": "pending",
  "creditsUsed": 3,
  "newBalance": 47,
  "estimatedCompletionTime": "1-3 minutes",
  "createdAt": 1740000000000
}

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)