Skip to main content
POST
/
suno
/
submit
/
music
Generate music
curl --request POST \
  --url https://api.gately.ai/suno/submit/music \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A relaxing jazz piano piece with soft drums",
  "title": "Relaxing Jazz",
  "tags": "jazz, relaxing, piano"
}
'

Documentation Index

Fetch the complete documentation index at: https://docs.gately.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Music Generation API

The Music Generation API allows you to create original music tracks from text prompts. Powered by advanced AI models, it can generate various musical styles, instrumentation, and moods.
Music Generation

​
Overview

Create AI-generated music by providing text prompts that describe the style, mood, and instrumentation you want. The API handles the request asynchronously:
  1. Submit a generation request with your prompt
  2. Receive a task ID for tracking
  3. Check the status until completion
  4. Download the generated music file
The OpenAPI playground above allows you to test music generation. Provide a detailed prompt describing the music you want to create.

​
Base URL

https://api.gately.ai/suno/submit/music

​
Request Format

curl --location 'https://api.gately.ai/suno/submit/music' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "prompt": "An upbeat electronic dance track with energetic synths and a catchy hook",
    "tags": "electronic, dance, upbeat",
    "title": "Dance Energy",
    "mv": "v5"
}'

​
Parameters

​
prompt
string
required
Detailed description of the music you want to generate
​
tags
string
Comma-separated list of genre tags
​
title
string
Title for the generated track
​
mv
string
default:"v5"
Model version to use

​
Response Format

{
  "status": "success",
  "data": {
    "task_id": "mus_bVDqJBrLStaPbCZXvLZrWqi4",
    "estimated_completion_time": 120
  }
}
​
task_id
string
Unique identifier for the generation task
​
estimated_completion_time
integer
Estimated time in seconds until completion

​
Checking Generation Status

Once you have a task_id, you can check the status of the music generation: 
curl --location 'https://api.gately.ai/suno/music/status/mus_bVDqJBrLStaPbCZXvLZrWqi4' \
--header 'Authorization: Bearer YOUR_API_KEY'

​
Status Response Format

{
  "status": "completed",
  "data": {
    "task_id": "mus_bVDqJBrLStaPbCZXvLZrWqi4",
    "audio_url": "https://storage.taam.cloud/music/mus_bVDqJBrLStaPbCZXvLZrWqi4.mp3",
    "cover_image": "https://storage.taam.cloud/music/covers/mus_bVDqJBrLStaPbCZXvLZrWqi4.jpg"
  }
}
Status codes:
  • queued: Task is in the queue
  • processing: Music is being generated
  • completed: Generation is complete
  • failed: Generation failed

​
Prompt Tips

Include specific genres, eras, or artists: “A jazz fusion track inspired by Weather Report with complex chord progressions”
Specify instruments: “An orchestral piece featuring prominent French horns, violins, and timpani”
Describe the feeling: “A melancholic piano ballad with emotional chord progressions”
Detail song structure: “A pop track with verse-chorus structure, building to an energetic bridge”

​
Example Prompts

{
  "prompt": "A futuristic electronic track with glitchy beats, atmospheric pads, and a driving bassline that evolves throughout",
  "tags": "electronic, ambient, glitch",
  "title": "Digital Horizon"
}

​
Limitations

  • Generated tracks are typically 1-2 minutes in length
  • Specific artist names should be used as inspiration only, not direct copying
  • Vocals are generated in a fictional language
  • Maximum of 50 active generations per account at once

Authorizations

​
Authorization
string
header
required

Enter your API key prefixed with 'Bearer '

Body

application/json
​
prompt
string
​
tags
string
​
mv
string
​
title
string

Response

200

Successful response