Docs
Suno API

Suno API

Documentation on our cost-friendly state-of-the-art music generation Model API (ALPHA TEST)

This service allows you access to APIs of endpoints for the most advanced music generation model - suno. Our service and pricing model best fit users who want high throughput scenarios.

Available models:

  • chirp-v3

Pricing

The price of generating new songs is 50% of Suno's Pro Plan . Details: Suno API pricing

Special Note

This API uses GoAPI Suno Quotas.
Like the suno official product, each generation will produce TWO music clips


Music Generation API

POST

https://api.goapi.ai/api/suno/v1/music

create music with suno chirp-v3

Parameters:

Header
NameTypeRequiredDescription
X-API-Keystring✔️Your GoAPI Key used for request authorization
Body
NameTypeRequiredDescription
custom_modeboolean✔️Defaults to false. By default this api needs very few params
inputjson✔️structure depends on whether its custom mode, see below

Response Codes:

200: OK
Successful Response
400: Bad Request
The request format does not meet the requirements.
401: Unauthorized
The API key is incorrect
500: Internal Server Error
Service is experiencing an error

Request Example (custom_mode is false)

import requests
import json
 
url = "https://api.goapi.ai/api/suno/v1/music"
 
payload = json.dumps({
  "custom_mode": False,
  "input": {
    "gpt_description_prompt": "sunshine", #your simple prompt
    "make_instrumental": False
  }
})
headers = {
  'X-API-Key': 'YOUR_GOAPI_KEY',
  'Content-Type': 'application/json'
}
 
response = requests.request("POST", url, headers=headers, data=payload)
 
print(response.text)

Request Example (custom_mode is true)

import requests
import json
 
url = "https://api.goapi.ai/api/suno/v1/music"
 
payload = json.dumps({
  "custom_mode": True,
  "input": {
    "prompt": "[Verse]\nTesla riding\nBatteries flying\nElon Musk\nHe's got the future on his mind\nSolar panels shining\nRockets reaching for the skies\nInnovation's flowing\nHe's the tech wizard of our times\n\n[Verse]\nNeuralink connecting minds\nAI running wild\nMars colonization\nHe's making it his style\nFrom PayPal he came and shook the world with his touch\nElon Musk\nThe eccentric genius\nHe's too much\n\n[Chorus]\nElon Musk\nHe's the man with electric dreams\nChanging the world with his technology schemes\nFrom PayPal to SpaceX\nHe's a force to be seen\nElectric cars and rockets\nHe's living the dream",
    "title": "Electric Dreams",
    "tags": "epic reggae",
    "continue_at": 0, #the second that this clip started from last clip. 0 means start over. Note that only GoAPI developer or above plan can use value not zero
    "continue_clip_id": "" #the id of the clip that you need to continue; empty string means brand new clip.
  }
})
headers = {
  'X-API-Key': 'YOUR_GOAPI_KEY',
  'Content-Type': 'application/json'
}
 
response = requests.request("POST", url, headers=headers, data=payload)
 
print(response.text)

Response Example

{
    "code": 200,
    "data": {
        "task_id": "56ea8da3-8507-4118-9f1e-111111111111"
    },
    "message": "success"
}

Generate the full song API

This is an api endpoint that only works for Extended Clips. The final result will be available in Get Result API

POST

https://api.goapi.ai/api/suno/v1/music/concat

generate the full song from extended clips

Parameters:

Header
NameTypeRequiredDescription
X-API-Keystring✔️Your GoAPI Key used for request authorization
Body
NameTypeRequiredDescription
clip_idstring✔️the last clip id that you extended

Response Codes:

200: OK
Successful Response
400: Bad Request
The request format does not meet the requirements.
401: Unauthorized
The API key is incorrect
500: Internal Server Error
Service is experiencing an error

Request Example

import requests
import json
 
url = "https://api.goapi.ai/api/suno/v1/music/concat"
 
payload = json.dumps({
  "clip_id": "36004000-c4db-47fc-86a2-111111111111"
})
headers = {
  'X-API-Key': 'your-goapi-key',
  'Content-Type': 'application/json'
}
 
response = requests.request("POST", url, headers=headers, data=payload)
 
print(response.text)

Response Example

{
    "code": 200,
    "data": {
        "task_id": "56ea8da3-8507-4118-9f1e-111111111111"
    },
    "message": "success"
}

Get Music Generation Result API

GET

https://api.goapi.ai/api/suno/v1/music/{task_id}

get music result

Parameters:

Header
NameTypeRequiredDescription
X-API-Keystring✔️Your GoAPI Key used for request authorization
Body
NameTypeRequiredDescription

Response Codes:

200: OK
Successful Response
400: Bad Request
The request format does not meet the requirements.
401: Unauthorized
The API key is incorrect
500: Internal Server Error
Service is experiencing an error

Request Example

import requests
 
url = "https://api.goapi.ai/api/suno/v1/music/56ea8da3-8507-4118-9f1e-111111111111"
 
payload={}
headers = {
  'X-API-Key': 'YOUR_GOAPI_KEY',
  'Content-Type': 'application/json'
}
 
response = requests.request("GET", url, headers=headers, data=payload)
 
print(response.text)

Response Example

{
    "code": 200,
    "data": {
        "task_id": "56ea8da3-8507-4118-9f1e-111111111111",
        "status": "completed",
        "input": "{\"custom_mode\":false,\"gpt_description_prompt\":\"blowing in the wind\",\"make_instrumental\":false,\"prompt\":\"\",\"title\":\"\",\"continue_at\":0,\"continue_clip_id\":\"\",\"mv\":\"chirp-v3-0\",\"tags\":\"\"}",
        "clips": {
            "e0fe8bba-fac8-460b-bf1c-111111111111": {
                "id": "e0fe8bba-fac8-460b-bf1c-111111111111",
                "video_url": "https://cdn1.suno.ai/e0fe8bba-fac8-460b-bf1c-111111111111.mp4",
                "audio_url": "https://cdn1.suno.ai/e0fe8bba-fac8-460b-bf1c-111111111111.mp3",
                "image_url": "https://cdn1.suno.ai/image_e0fe8bba-fac8-460b-bf1c-111111111111.png",
                "image_large_url": "https://cdn1.suno.ai/image_large_e0fe8bba-fac8-460b-bf1c-111111111111.png",
                "is_video_pending": false,
                "major_model_version": "v3",
                "model_name": "chirp-v3",
                "metadata": {
                    "tags": "acoustic folk ballad",
                    "prompt": "[Verse]\nLeaves whisper\nTrees sway\nIn the wind\nWe all play\nQuestions fly\nAnswers hide\nIn this world\nSide by side\n\n[Verse 2]\nBirds soar\nClouds roam\nIn the breeze\nWe find home\nSearching for truth\nIn the sky\nAs the wind carries our sigh\n\n[Chorus]\nBlowin' in the breeze\nWe're like the leaves\nWonderin' where life takes us\nWhere it leads\nWith every gust\nWe let go of what we know\nBlowin' in the breeze\nWe're free to grow",
                    "gpt_description_prompt": "blowing in the wind",
                    "audio_prompt_id": "",
                    "history": null,
                    "concat_history": null,
                    "type": "gen",
                    "duration": 108.8,
                    "refund_credits": false,
                    "stream": true,
                    "error_type": null,
                    "error_message": null
                },
                "is_liked": false,
                "is_handle_updated": false,
                "is_trashed": false,
                "reaction": null,
                "created_at": "2024-04-18T14:29:31.760Z",
                "status": "complete",
                "title": "Blowin' in the Breeze",
                "play_count": 0,
                "upvote_count": 0,
                "is_public": false
            },
            "f66f7a6f-a868-464f-b280-111111111111": {
                "id": "f66f7a6f-a868-464f-b280-111111111111",
                "video_url": "https://cdn1.suno.ai/f66f7a6f-a868-464f-b280-111111111111.mp4",
                "audio_url": "https://cdn1.suno.ai/f66f7a6f-a868-464f-b280-111111111111.mp3",
                "image_url": "https://cdn1.suno.ai/image_f66f7a6f-a868-464f-b280-111111111111.png",
                "image_large_url": "https://cdn1.suno.ai/image_large_f66f7a6f-a868-464f-b280-111111111111.png",
                "is_video_pending": false,
                "major_model_version": "v3",
                "model_name": "chirp-v3",
                "metadata": {
                    "tags": "acoustic folk ballad",
                    "prompt": "[Verse]\nLeaves whisper\nTrees sway\nIn the wind\nWe all play\nQuestions fly\nAnswers hide\nIn this world\nSide by side\n\n[Verse 2]\nBirds soar\nClouds roam\nIn the breeze\nWe find home\nSearching for truth\nIn the sky\nAs the wind carries our sigh\n\n[Chorus]\nBlowin' in the breeze\nWe're like the leaves\nWonderin' where life takes us\nWhere it leads\nWith every gust\nWe let go of what we know\nBlowin' in the breeze\nWe're free to grow",
                    "gpt_description_prompt": "blowing in the wind",
                    "audio_prompt_id": "",
                    "history": null,
                    "concat_history": null,
                    "type": "gen",
                    "duration": 103.2,
                    "refund_credits": false,
                    "stream": true,
                    "error_type": null,
                    "error_message": null
                },
                "is_liked": false,
                "is_handle_updated": false,
                "is_trashed": false,
                "reaction": null,
                "created_at": "2024-04-18T14:29:31.761Z",
                "status": "complete",
                "title": "Blowin' in the Breeze",
                "play_count": 0,
                "upvote_count": 0,
                "is_public": false
            }
        }
    },
    "message": "success"
}

Lyrics Synthesis API

POST

https://api.goapi.ai/api/suno/v1/lyrics

synthesis lyrics with suno

Parameters:

Header
NameTypeRequiredDescription
X-API-Keystring✔️Your GoAPI Key used for request authorization
Body
NameTypeRequiredDescription
promptstring✔️your prompt to guide suno to write lyrics

Response Codes:

200: OK
Successful Response
400: Bad Request
The request format does not meet the requirements.
401: Unauthorized
The API key is incorrect
500: Internal Server Error
Service is experiencing an error

Request Example

import requests
import json
 
url = "https://api.goapi.ai/api/suno/v1/lyrics"
 
payload = json.dumps({
  "prompt": "elon musk in the house"
})
headers = {
  'X-API-Key': 'YOUR_GOAPI_KEY',
  'Content-Type': 'application/json'
}
 
response = requests.request("POST", url, headers=headers, data=payload)
 
print(response.text)

Response Example

{
    "code": 200,
    "data": {
        "task_id": "56ea8da3-8507-4118-9f1e-111111111111"
    },
    "message": "success"
}

Get Lyrics Synthesis Result API

GET

https://api.goapi.ai/api/suno/v1/lyrics/{task_id}

get lyrics synthesis result

Parameters:

Header
NameTypeRequiredDescription
X-API-Keystring✔️Your GoAPI Key used for request authorization
Body
NameTypeRequiredDescription

Response Codes:

200: OK
Successful Response
400: Bad Request
The request format does not meet the requirements.
401: Unauthorized
The API key is incorrect
500: Internal Server Error
Service is experiencing an error

Request Example

import requests
 
url = "https://api.goapi.ai/api/suno/v1/lyrics/56ea8da3-8507-4118-9f1e-111111111111"
 
payload={}
headers = {
  'X-API-Key': 'YOUR_GOAPI_KEY',
  'Content-Type': 'application/json'
}
 
response = requests.request("GET", url, headers=headers, data=payload)
 
print(response.text)

Response Example

{
    "code": 200,
    "data": {
        "task_id": "0af7cdc7-5d21-4361-bd05-111111111111",
        "input": "{\"prompt\":\"elon musk in the house\"}",
        "status": "completed",
        "title": "Electric Dreams",
        "text": "[Verse]\nTesla riding\nBatteries flying\nElon Musk\nHe's got the future on his mind\nSolar panels shining\nRockets reaching for the skies\nInnovation's flowing\nHe's the tech wizard of our times\n\n[Verse]\nNeuralink connecting minds\nAI running wild\nMars colonization\nHe's making it his style\nFrom PayPal he came and shook the world with his touch\nElon Musk\nThe eccentric genius\nHe's too much\n\n[Chorus]\nElon Musk\nHe's the man with electric dreams\nChanging the world with his technology schemes\nFrom PayPal to SpaceX\nHe's a force to be seen\nElectric cars and rockets\nHe's living the dream"
    },
    "message": "success"
}