Skip to main content
POST
/
suno
/
generate
Step 3: Cover Music
curl --request POST \
  --url https://gptproto.com/suno/generate \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "<string>",
  "generation_type": "<string>",
  "tags": "<string>",
  "negative_tags": "<string>",
  "mv": "<string>",
  "title": "<string>",
  "continue_clip_id": "<string>",
  "continue_at": "<string>",
  "continued_aligned_prompt": "<string>",
  "infill_start_s": "<string>",
  "infill_end_s": "<string>",
  "task": "<string>",
  "cover_clip_id": "<string>"
}'
{
  "error": {
    "message": "Invalid request parameters",
    "type": "invalid_request_error",
    "code": "invalid_parameters"
  }
}

​
Overview

Music generation interface, can generate new music directly or continue existing musicIf you want to continue a user-uploaded music, you need to add -upload after the mv field, for example chirp-v3-5-upload

​
Authentication

This endpoint requires authentication using a Bearer token.
​
Authorization
string
required
Your API key in the format: Bearer YOUR_API_KEY

​
Request Body

​
prompt
string
required
Prompt parameter
​
generation_type
string
Generation Type parameter
​
tags
string
Tags parameter
​
negative_tags
string
Negative Tags parameter
​
mv
string
Mv parameter
​
title
string
Title parameter
​
continue_clip_id
string
Continue Clip Id parameter
​
continue_at
string
Continue At parameter
​
continued_aligned_prompt
string
Continued Aligned Prompt parameter
​
infill_start_s
string
Infill Start S parameter
​
infill_end_s
string
Infill End S parameter
​
task
string
Task parameter
​
cover_clip_id
string
Cover Clip Id parameter

​
Request Example

curl -X POST "https://gptproto.com/suno/generate" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "[Verse]\nStars they shine above me\nMoonlight softly glows\nWhispers in the night sky\nDreams that only grow\n\n[Verse 2]\nMidnight winds are calling\nCarrying a tune\nHeartbeats echo softly\nDancing with the moon\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way\n\n[Verse 3]\nShadows move and twinkle\nNighttime come alive\nMystery in the heavens\nStories that survive\n\n[Bridge]\nMagic fills the darkness\nWonder in the air\nEvery star a secret\nIn the sky I stare\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way",
  "generation_type": "TEXT",
  "tags": "rock, punk",
  "negative_tags": "",
  "mv": "chirp-v3-5-tau",
  "title": "Starry (Cover)",
  "continue_clip_id": null,
  "continue_at": null,
  "continued_aligned_prompt": null,
  "infill_start_s": null,
  "infill_end_s": null,
  "task": "cover",
  "cover_clip_id": "0438be7f-6f3f-4c3d-9616-ea218c602854"
}'

​
Response

​
Success
200
Successful response
{
  "status": "success"
}

​
Error Responses

{
  "error": {
    "message": "Invalid request parameters",
    "type": "invalid_request_error",
    "code": "invalid_parameters"
  }
}