ToAPIsToAPIs
Suno 音樂

資產類操作

persona 人聲角色,createVoice 克隆聲音,createModel 自訂模型訓練,vox 人聲提取

POST
/v1/music/generations/persona

資產類操作產出可在後續請求中複用的上游資產 ID(如 persona_id / voice_id / model_id)。

POST https://toapis.com/v1/music/generations/{operation}
modelstring請求體必填
固定 "suno"

persona — 人聲角色($0.004)

從已有歌曲提取人聲角色,產出 persona_id 供 generation 等操作複用。

task_idstring請求體必填
源任務 ID
namestring請求體必填
角色名稱
describestring請求體
角色描述(可選)

createVoice — 克隆聲音($0.016)

audio_urlstring請求體必填
源音訊 URL,需乾淨的人聲片段,混音成品會被上游拒絕
namestring請求體
聲音名稱

createModel — 自訂模型訓練($0.96)

用 6-24 條音訊訓練自訂模型,產出 custom_model_id,後續 generation 傳該 ID 即可使用(使用自訂模型時需省略 version 與 persona_id)。

namestring請求體必填
模型名稱
audio_urlsarray請求體必填
6-24 條公網音訊 URL
curl --request POST \
  --url https://toapis.com/v1/music/generations/createModel \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{"model":"suno","name":"my-voice-model","audio_urls":["https://.../a.mp3","https://.../b.mp3","..."]}'

vox — 人聲提取($0.004,舊版)

task_idstring請求體必填
源任務 ID
vocal_start_snumber請求體
人聲段起點(秒,可選)
vocal_end_snumber請求體
人聲段終點(秒,可選)
stylesstring請求體
風格(可選)
已廢棄,上游建議使用 persona。

Response

task_idstring
任務 ID
statusstring
submitted