Skip to main content
POST
/
v1
/
music
/
generations
curl -X POST "https://api.lemondata.cc/v1/music/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno_music",
    "prompt": "An upbeat electronic dance track with heavy bass",
    "title": "Night Drive",
    "tags": "electronic, EDM, energetic"
  }'
{
  "id": "music_abc123",
  "status": "pending",
  "created": 1706000000,
  "model": "suno_music"
}
Generate music and lyrics using AI. This is an asynchronous API - you’ll receive a task ID to poll for completion.

Request Body

model
string
default:"suno_music"
Model to use: suno_music for music generation, suno_lyrics for lyrics only.
prompt
string
required
Description of the music to generate. Can include style, mood, instruments, etc.
title
string
Title for the generated song.
tags
string
Style tags (e.g., “pop, upbeat, electronic”).
action
string
Generation type: MUSIC (default) or LYRICS.
mv
string
Model version to use.
continue_clip_id
string
ID of a previous clip to continue from.
continue_at
number
Timestamp (in seconds) to continue from.
user
string
A unique identifier for the end-user.

Response

id
string
Task ID for polling status.
status
string
Task status: pending, processing, completed, or failed.
created
integer
Unix timestamp of task creation.
curl -X POST "https://api.lemondata.cc/v1/music/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno_music",
    "prompt": "An upbeat electronic dance track with heavy bass",
    "title": "Night Drive",
    "tags": "electronic, EDM, energetic"
  }'
{
  "id": "music_abc123",
  "status": "pending",
  "created": 1706000000,
  "model": "suno_music"
}

Body

application/json
prompt
string
required

Description of the music to generate. Can include style, mood, instruments, etc.

model
string

Model to use: suno_music for music generation, suno_lyrics for lyrics only.

title
string

Title for the generated song.

tags
string

Style tags (e.g., “pop, upbeat, electronic”).

action
string

Generation type: MUSIC (default) or LYRICS .

mv
string

Model version to use.

continue_clip_id
string

ID of a previous clip to continue from.

continue_at
number

Timestamp (in seconds) to continue from.

user
string

A unique identifier for the end-user.

Response

200 - application/json

Response 200

id
string

Task ID for polling status.

status
string

Task status: pending , processing , completed , or failed .

created
integer

Unix timestamp of task creation.