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

# Producer 歌詞生成接口 API 對接說明

> Producer Music Generation 集成指南 - XHuoAPI

Producer 允許我們透過提示詞來生成歌詞，本文檔講解相關 API 的對接方法。

該 API 只有一個輸入參數，就是 `prompt`，它是生成歌詞的提示詞。

這裡我們輸入的 `prompt` 是 `A song about winter`，是生成歌詞的提示詞。

```bash theme={null}
curl -X POST 'https://api.xhuoapi.ai/v1/producer/lyrics' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "prompt": "A song about winter"
}'
```

結果如下：

```
{
    "success": true,
    "task_id": "d354b519-43c0-4888-a3da-83adbf845fd6",
    "data": {
        "title": "Mercy in the Trees",
        "lyrics": "[Verse 1]\n我走出鐵路院\n那裡的松樹厚厚地覆蓋著霜\n雪不在乎我做了什麼\n它一樣覆蓋一切\n\n[Verse 2]\n有一座由白樺樹幹做成的小教堂\n祭壇就是地面\n我像個叛徒一樣跪在那裡\n等待寂靜的原諒\n\n[Chorus]\n冬天是一件沉重的外套\n冬天是一件沉重的外套\n\n[Verse 3]\n你在第一場暴風雪之前就離開了\n我留下來看著世界變白\n現在每一根樹枝都是一根骨頭\n而我只是在數著剩下的\n\n[Verse 4]\n他們說寒冷會殺了你\n但我認為它只是讓你誠實\n在這裡與冰冷的土地\n沒有地方可以藏你的手\n\n[Chorus]\n冬天是一件沉重的外套\n冬天是一件沉重的外套\n\n[Verse 5]\n我在口袋裡找到你的信\n墨水因為融化而滲透\n但我仍然能讀到憐憫\n寫在空白的空間之間\n\n[Outro]\n樹木不要求赦免\n它們只是站在那裡，赤裸而真實\n我正在學習如何做到這一點\n讓雪埋葬它需要埋葬的東西"
    }
}
```

可以看到，`data` 的 `lyrics` 欄位就是生成的歌詞內容。