资产类操作 | ToAPIs Documentation

POST

/v1/music/generations/persona

国内用户请注意： 中国大陆用户请使用 https://toapis.cn 作为接口地址（Base URL）。

资产类操作产出可在后续请求中复用的上游资产 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