gptproto Api
  1. Scenario 4: Generate music directly through prompt (pure music)
gptproto Api
  • OpenAI
    • GPT 4o image
      • chat format
        • chat mode
      • image/generations
        • Create Image
        • Image Editing
    • Our GPT models(GPT Series)
      • GPT-4o
        • chat text mode
        • chat image mode
      • GPT-4.1
        • responses mode
    • Our reasoning models (O Series)
      • responses mode
    • audio
      • transcriptions
      • speech
  • Claude
    • chat mode(Support pdf analysis)
      POST
  • Gemini
    • veo3 Video
      • chat Format
        • Text to Video
        • Image to Video
      • Asyn mode(16:9)
        • Create Video
        • Get Task Status
      • Asyn mode(9:16)
        • Create Video
        • Get Task Status
    • Gemini Series
      • chat text mode
      • chat image mode
  • Grok
    • chat text mode(Support for grok4)
      POST
  • Midjourney
    • Task Query
      • ListByCondition
      • FetchFromTask
    • Task Submission
      • Blend
      • SwapFace
      • Describe
      • Imagine
      • Modal
      • Action
      • Change
  • Suno
    • All APIs
      • Music Generation(generations)
      • 查询任务(feed)
      • Generate Lyrics
      • Query Lyrics
    • Scene 1 Generate Custom Music(with Lyrics)
      • Music Generation(generations)
    • Scene 2 Generate Music Directly Through Prompt(with Lyrics)
      • Music Generation(generations)
    • Scenario 3: Generate Custom Music (Pure Music)
      • Music Generation (generations)
    • Scenario 4: Generate music directly through prompt (pure music)
      • Music Generation (generations)
        POST
    • Scenario 5: Upload Custom Audio and Continue
      • Convert Music Link to Suno (Upload)
      • Music Generation (generations)
    • Scenario 6: Continue Writing Music and Get Complete Music
      • Step 1: Music Generation
      • Step 3: Extend Music
      • Step 5: Get Complete Music
    • Scenario 7: Cover Music (Music Version, Modify Style)
      • Step 1: Music Generation
      • Step 3: Cover Music
  • Kling
    • Kling(Official Format)
      • Image Generation
      • text to video
      • Image to Video
      • Query Task
  • Runway
    • Official Format
      • Act-two Emotion Migration
      • Act-one Emotion Migration
      • generate Generate Task
      • video2video(Video to Video, Style Re-drawing)
      • Submit Video Generation Task
      • Query Task
  • Ideogram
    • Official Format
      • Edit 3.0(edit)
      • Remix 3.0(remix)
      • Replace Background 3.0(replace-background)
      • Generate 3.0(generate)
  • Flux
    • Flux Chat Format
      • Chat Format
    • Flux Image Format
      • ImageGenerate
  • Doubao
    • chat text mode
    • chat image mode
    • seededit-3.0
    • seedream-3.0
    • seedance-1.0
  • higgsfield
    • query action template
    • generate video
    • query task
  1. Scenario 4: Generate music directly through prompt (pure music)

Music Generation (generations)

POST
/suno/generate
Generate music interface, can generate directly or continue to write music
If you are continuing to write a user-uploaded music, you need to add -upload after the mv field, such as chirp-v3-5-upload

Request

Body Params application/json

Example
{
    "gpt_description_prompt": "an anthemic dancepop song about dancing all night long",
    "mv": "chirp-v3-5",
    "prompt": "",
    "make_instrumental": true
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://gptproto.com/suno/generate' \
--header 'Content-Type: application/json' \
--data-raw '{
    "gpt_description_prompt": "an anthemic dancepop song about dancing all night long",
    "mv": "chirp-v3-5",
    "prompt": "",
    "make_instrumental": true
}'

Responses

🟢200Success
application/json
Body

Examples
{"id":"3d5f0ee4-1d7b-410a-bafd-60a3978284d1","clips":[{"id":"7070ec00-462e-42ac-9b9f-1074977f473f","video_url":"","audio_url":"","image_url":null,"image_large_url":null,"is_video_pending":false,"major_model_version":"v3","model_name":"chirp-v3","metadata":{"tags":"heavy metal","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","gpt_description_prompt":null,"audio_prompt_id":"m_2e584f32-7ae3-4b2d-93f6-391f65a01f15","history":[{"id":"m_2e584f32-7ae3-4b2d-93f6-391f65a01f15","continue_at":48.762,"type":"upload","source":"web","infill":false}],"concat_history":null,"type":"gen","duration":null,"refund_credits":null,"stream":true,"infill":false,"has_vocal":true,"is_audio_upload_tos_accepted":true,"error_type":null,"error_message":null},"is_liked":false,"user_id":"4ed4f182-0b5a-4cde-bffe-44fb5237a3aa","display_name":"AmbientLens971","handle":"ambientlens971","is_handle_updated":false,"avatar_image_url":"https://cdn1.suno.ai/defaultOrange.jpg","is_trashed":false,"reaction":null,"created_at":"2024-07-22T07:56:36.710Z","status":"submitted","title":"Starry ","play_count":0,"upvote_count":0,"is_public":false},{"id":"00e6b9e4-c29c-4cfe-8d7a-5b3f06ff5b90","video_url":"","audio_url":"","image_url":null,"image_large_url":null,"is_video_pending":false,"major_model_version":"v3","model_name":"chirp-v3","metadata":{"tags":"heavy metal","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","gpt_description_prompt":null,"audio_prompt_id":"m_2e584f32-7ae3-4b2d-93f6-391f65a01f15","history":[{"id":"m_2e584f32-7ae3-4b2d-93f6-391f65a01f15","continue_at":48.762,"type":"upload","source":"web","infill":false}],"concat_history":null,"type":"gen","duration":null,"refund_credits":null,"stream":true,"infill":false,"has_vocal":true,"is_audio_upload_tos_accepted":true,"error_type":null,"error_message":null},"is_liked":false,"user_id":"4ed4f182-0b5a-4cde-bffe-44fb5237a3aa","display_name":"AmbientLens971","handle":"ambientlens971","is_handle_updated":false,"avatar_image_url":"https://cdn1.suno.ai/defaultOrange.jpg","is_trashed":false,"reaction":null,"created_at":"2024-07-22T07:56:36.711Z","status":"submitted","title":"Starry ","play_count":0,"upvote_count":0,"is_public":false}],"metadata":{"tags":"heavy metal","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","gpt_description_prompt":null,"audio_prompt_id":"m_2e584f32-7ae3-4b2d-93f6-391f65a01f15","history":[{"id":"m_2e584f32-7ae3-4b2d-93f6-391f65a01f15","continue_at":48.762,"type":"upload","source":"web","infill":false}],"concat_history":null,"type":"gen","duration":null,"refund_credits":null,"stream":true,"infill":false,"has_vocal":true,"is_audio_upload_tos_accepted":true,"error_type":null,"error_message":null},"major_model_version":"v3","status":"complete","created_at":"2024-07-22T07:56:36.699Z","batch_size":1}
Modified at 2025-07-08 06:45:04
Previous
Music Generation (generations)
Next
Convert Music Link to Suno (Upload)
Built with