跳轉到主要內容

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.

SUNO 允許我們透過任意音頻檔案建立自訂聲音角色，實現聲音克隆用於音樂生成。與已有的 Persona API（使用 Suno 生成的 audio_id）不同，該 API 接受一個公開可訪問的 audio_url，即你自己的人聲錄音。本文檔講解聲音克隆 API 的對接方法。

​
第一步：建立聲音角色

該 API 有三個輸入參數：audio_url（必填），為一個公開可訪問的 MP3 或 WAV 格式音頻檔案 URL，其中包含單人清晰人聲；name 和 description（可選），為聲音角色的名稱和描述。 音頻檔案要求：
  • 格式：MP3 或 WAV
  • 時長：至少 10 秒
  • 內容：單人清晰人聲，盡量減少背景噪音或音樂
curl -X POST 'https://api.xhuoapi.ai/v1/suno/voices' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "audio_url": "http://cos.aitutu.cc/mp4/ru-user-voice.mp3",
  "name": "RU User Voice Test",
  "description": "用戶語音錄音示例"
}'
結果如下： 
{
  "success": true,
  "task_id": "b9150e51-d87c-4556-a55e-100947a63bdf",
  "data": {
    "persona_id": "e95013f8-eaee-4741-a42f-1d559a9d0b2b",
    "name": "RU User Voice Test",
    "is_public": false
  }
}
可以看到，data 的 persona_id 欄位就是建立的聲音角色 ID。is_public 欄位始終為 false，因為透過上傳音頻建立的聲音角色是私有的。

​
第二步：使用聲音角色生成音樂

有了聲音角色 ID 之後，我們便可以使用 Suno Audios Generation API 來進行音樂生成了。將 action 設為 generate，並將 persona_id 設為上面返回的聲音角色 ID，生成的歌曲將使用克隆的聲音進行演唱。
注意： 聲音克隆僅支援 chirp-v4-5 及以上模型（如 chirp-v4-5、chirp-v5、chirp-v5-5），不支援 chirp-v4。 
curl -X POST 'https://api.xhuoapi.ai/v1/suno/audios' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "generate",
  "model": "chirp-v5-5",
  "prompt": "A warm synth-pop song about city nights",
  "persona_id": "e95013f8-eaee-4741-a42f-1d559a9d0b2b"
}'
結果如下： 
{
  "success": true,
  "task_id": "53d8a334-a972-43c5-895e-60c4454e88d5",
  "data": [
    {
      "id": "16463960-077c-4700-bbb3-3c7897b943d3",
      "title": "Soft Neon on My Skin",
      "audio_url": "https://cdn1.suno.ai/16463960-077c-4700-bbb3-3c7897b943d3.mp3",
      "image_url": "https://cdn2.suno.ai/image_16463960-077c-4700-bbb3-3c7897b943d3.jpeg",
      "model": "chirp-v5-5",
      "state": "succeeded",
      "prompt": "A warm synth-pop song about city nights",
      "duration": 156.28
    }
  ]
}
可以看到，生成的歌曲使用了克隆的聲音進行演唱。persona_id 也可以與 cover 動作配合使用，用克隆的聲音翻唱已有歌曲。