> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Suno 歌詞生成 API 對接說明

> Suno Music Generation 整合指南 - Ace Data Cloud

如果你想自訂生成歌曲，但又不太想自己編寫歌詞，可以使用 AceDataCloud 提供的歌詞生成 API 來通過 prompt 生成歌詞，API 是 [Suno Lyrics Generation API](https://platform.acedata.cloud/documents/suno-lyrics)。

該 API 主要輸入參數是 `prompt`，可選 `model`（可選值 `default`、`remi-v1`，默認 `default`），填寫樣例如下：

![](https://cdn.acedata.cloud/p53wtj.png)

這裡我們輸入的 `prompt` 是 `A song about winter`，生成和冬天相關的歌曲。

點擊運行，結果如下：

```json theme={null}
{
  "success": true,
  "task_id": "2e26f7ff-0b82-4a60-bb9b-78db89f98b51",
  "data": [
    {
      "text": "[Verse]\nSnowflakes falling from the sky\nWinter's cold touch\nOh how it gets me high\nI bundle up in layers\nOh so cozy\nStepping out and feeling the frost on my nose\n\n[Chorus]\nOh\nWinter's cold touch\nIt's a season that I love so much\nSnowfall brings a feeling so divine\nWinter's cold touch\nIt's a magical time",
      "title": "Winter's Cold Touch",
      "status": "complete",
      "tags": ["dreamy, mellow, ballad"]
    },
    {
      "text": "[Verse]\nThe world is covered in a blanket of white\nIcicles hanging\nShimmering so bright\nThe chilly air fills my lungs with every breath\nWalking in the snow\nLeaving footprints behind\n\n[Chorus]\nWinter wonderland\nEverything is so bright\nWinter wonderland\nHold me through the night",
      "title": "Winter Wonderland",
      "status": "complete",
      "tags": ["dream pop, mellow, shoegaze"]
    }
  ],
  "started_at": 1780684179.15,
  "finished_at": 1780684186.583,
  "elapsed": 7.433
}
```

可以看到，`data` 是一個數組，每次會返回多個歌詞候選，其中每個元素的 `text` 欄位就是歌詞內容，`title` 是標題，`tags` 是推薦的曲風標籤。

有了歌詞之後，我們便可以使用 [Suno Audios Generation API](https://platform.acedata.cloud/documents/suno-audios) 來進行自訂歌曲生成了。