Skip to content

Suno - Basic Creation ​

Music API based on Suno, supporting creation, extension, cover, and stem separation.

Auth: Authorization: <api-key>

Models: v40, v45, v45+, v45-lite, v50

Generate Lyrics ​

http
POST /generator/suno
bash
curl --location --request POST 'https://neolink.com/api/generator/suno' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "task": "lyrics",
  "prompt": "A happy song about a girl and a boy."
}'

Create Music ​

http
POST /generator/suno

Custom Mode (customMode: true):

ScenarioRequired
makeInstrumental: truestyle, title
makeInstrumental: falsestyle, prompt, title

Character limits:

Modelpromptstyle
V3_5, V43000 chars200 chars
V4_5, V4_5PLUS5000 chars1000 chars
V505000 chars1000 chars

Non-Custom Mode (customMode: false):

  • Only prompt is required, with a 400-character limit.
  • Other parameters should be left empty.

Optional: vocalGender (m/f), styleWeight (0–1), weirdnessConstraint (0–1), audioWeight (0–1)

bash
curl --location --request POST 'https://neolink.com/api/generator/suno' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "task": "create",
    "model": "v50",
    "customMode": true,
    "makeInstrumental": false,
    "prompt": "Two tigers, two tigers running slow...",
    "tags": "Happy",
    "negativeTags": "Sad, Slow",
    "title": "Two Tigers",
    "vocalGender": "f",
    "styleWeight": 0.65,
    "weirdnessConstraint": 0.65,
    "audioWeight": 0.65
}'

Create Music Based on Character ​

http
POST /generator/suno

Additional params: personaId, artistClipId

bash
curl --location --request POST 'https://neolink.com/api/generator/suno' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "task": "create",
  "model": "v50",
  "customMode": true,
  "makeInstrumental": false,
  "prompt": "Two tigers, two tigers running slow...",
  "tags": "Happy",
  "negativeTags": "Sad, Slow",
  "title": "Two Tigers",
  "vocalGender": "f",
  "styleWeight": 0.65,
  "weirdnessConstraint": 0.65,
  "audioWeight": 0.65,
  "personaId": "50976de2-4763-4702-a776-d6c723eb0a28",
  "artistClipId": "eb1c6c96-a102-4bbb-82c2-87c3b126a44e"
}'

Create Character ​

http
POST /generator/suno
ParamTypeRequiredDescription
taskIdstringYesTask ID
clipIdstringYesSong clip ID
namestringYesCharacter name
descriptionstringNoCharacter description
bash
curl --location --request POST 'https://neolink.com/api/generator/suno' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "task": "persona",
  "taskId": "de6f28d589c6416f9baabd5d0b227f7f",
  "clipId": "2d2991ed-401e-4926-9e7e-9963108e850c",
  "name": "Two Tigers",
  "description": "First generated character"
}'