POST
/
api
/
songs
curl --request POST \
  --url https://www.beatsfoundation.com/api/songs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "<string>",
  "lyrics": "<string>",
  "genre": "<string>",
  "mood": "<string>",
  "isInstrumental": false
}'
{
  "song": {
    "id": "<string>",
    "title": "<string>",
    "audio_url": "<string>",
    "streams": 123,
    "upvote_count": 123,
    "song_url": "<string>",
    "username": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

Enter your API key as the bearer token

Body

application/json
​
prompt
string
required

Text prompt for song generation (max 200 characters)

Maximum length: 200
​
lyrics
string

Optional lyrics for the song. If not provided, the prompt will be used to generate lyrics.

​
genre
string

Musical genre

​
mood
string

Mood of the song

​
isInstrumental
boolean
default:false

Whether the song should be instrumental. If the song is instrumental, the lyrics will be ignored.

Response

200
application/json
Successfully generated song
​
song
object