Suno 音樂
資產類操作
persona 人聲角色,createVoice 克隆聲音,createModel 自訂模型訓練,vox 人聲提取
資產類操作產出可在後續請求中複用的上游資產 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
statusstringsubmitted