Custom Audio Generation

Generate audio with custom mode in Suno AI.

Generates audio using a prompt with custom settings in Suno AI, allowing for tailored audio outputs.

POSThttps://api.aimlapi.com/generate/custom-mode

Body

application/json

prompt*string

tags*string

title*string

make_instrumental*boolean

wait_audio*boolean

Response

201

Body

application/json

image_url*string (uri)

audio_url*string (uri)

video_url*string (uri)

Request

JavaScriptCurlPython

const response = await fetch('https://api.aimlapi.com/generate/custom-mode', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify([
      {
        "prompt": "text",
        "tags": "text",
        "title": "text",
        "make_instrumental": false,
        "wait_audio": false
      }
    ]),
});
const data = await response.json();

Response

201

{
  "image_url": "https://example.com",
  "audio_url": "https://example.com",
  "video_url": "https://example.com"
}

Our API allows you to generate music with custom settings using the Suno v3.5 model. Available models include chirp-v3-5 and chirp-v3-0.

Parameters

• Audio Files: 2 audio files will be generated for each request, consuming a total of 200 000 AI/ML Tokens.

• wait_audio:

  • By default (false), the request operates in background mode, returning only audio task information. You must call the get API to retrieve detailed audio information.

  • If set to true, it simulates synchronous mode, waiting up to 100 seconds for audio generation, and directly returns the audio link and other information. Recommended for use in GPTs and other agents.

Examples

generate.py

import requests

url = "https://api.aimlapi.com/generate/custom-mode"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "prompt": "Create an energetic dance music track",
    "tags": "dance, energetic",
    "title": "Dance Track",
    "make_instrumental": False,
    "wait_audio": True
}
response = requests.post(url, json=payload, headers=headers)
print(response.content)

generate.js

const axios = require('axios');

const url = 'https://api.aimlapi.com/generate/custom-mode';
const headers = {
  'Authorization': 'Bearer YOUR_API_KEY',
  'Content-Type': 'application/json'
};
const payload = {
  'prompt': 'Create an energetic dance music track',
  'tags': 'dance, energetic',
  'title': 'Dance Track',
  'make_instrumental': false,
  'wait_audio': true
};

axios.post(url, payload, { headers: headers, responseType: 'arraybuffer' })
  .then(response => {
    console.log(response.data);
  })
  .catch(error => {
    console.error(error);
  });

Your own lyrics

In order to generate music with your own lyrics use [Verse], [Chorus], [Bridge] indicators in the prompt as shown in the example below.

{
    "prompt": "[Verse 1]\nCruel flames of war engulf this land\nBattlefields filled with death and dread\nInnocent souls in darkness, they rest\nMy heart trembles in this silent test\n\n[Verse 2]\nPeople weep for loved ones lost\nBattered bodies bear the cost\nSeeking peace and hope once known\nOur grief transforms to hearts of stone\n\n[Chorus]\nSilent battlegrounds, no birds' song\nShadows of war, where we don't belong\nMay flowers of peace bloom in this place\nLet's guard this precious dream with grace\n\n[Bridge]\nThrough the ashes, we will rise\nHand in hand, towards peaceful skies\nNo more sorrow, no more pain\nTogether, we'll break these chains\n\n[Chorus]\nSilent battlegrounds, no birds' song\nShadows of war, where we don't belong\nMay flowers of peace bloom in this place\nLet's guard this precious dream with grace\n\n[Outro]\nIn unity, our strength will grow\nA brighter future, we'll soon know\nFrom the ruins, hope will spring\nA new dawn, we'll together bring",
    "tags": "pop metal male melancholic",
    "title": "Silent Battlefield",
    "make_instrumental": false,
    "wait_audio": true
}