Custom Audio Generation

在 Suno AI 中使用自定义模式生成音频。

post

使用 Suno AI 中具有自定义设置的提示生成音频，从而实现定制的音频输出。

请求体object[]

application/json

promptstring必填

tagsstring必填

titlestring必填

make_instrumentalboolean必填

wait_audioboolean必填

响应

201成功

application/json

post

/generate/custom-mode

HTTPcURLJavaScriptPython

POST /generate/custom-mode HTTP/1.1
Host: api.aimlapi.com
Content-Type: application/json
Accept: */*
Content-Length: 91

[
  {
    "prompt": "text",
    "tags": "text",
    "title": "text",
    "make_instrumental": true,
    "wait_audio": true
  }
]

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
}