跳转到主要内容
POST
/
suno
/
v2
/
voicePersona
/
init
init voice persona
curl --request POST \
  --url https://api.mountsea.ai/suno/v2/voicePersona/init \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "voice_audio_url": "https://example.com/my-voice.wav",
  "language": "zh",
  "vocal_start_s": 0,
  "vocal_end_s": 12.6
}
'
{
  "taskId": "15c257ff-43f7-4678-bd41-202ad6b8488b"
}
这是 Voice Persona 创建工作流程的第一阶段。详情请参阅完整工作流程指南。
调用 init 后，轮询返回的 taskId，等待状态变为 awaiting（不是 success）。data 字段将包含 phrase_text — 用户需要朗读并录制的文本。 获得录音后，在 30 秒内使用相同的 taskId 调用 Complete。
language 参数决定验证短语的语言。请选择与用户语音音频匹配的语言以获得最佳效果。支持的语言：zh、en、ja、ko、es、fr、de、pt、ru、hi。

授权

​
Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
​
voice_audio_url
string<uri>
必填

用户原声音频的可下载 URL（WAV/MP3）

示例:

"https://example.com/my-voice.wav"

​
language
string
必填

验证短语语言: zh | en | ja | ko | es | fr | de | pt | ru | hi

示例:

"zh"

​
vocal_start_s
number

人声提取起始秒，默认 0

示例:

0

​
vocal_end_s
number

人声提取结束秒，默认由 Suno 自动检测

示例:

12.6

响应

201 - application/json
​
taskId
string
必填

task id. Use this id to query task status.

示例:

"15c257ff-43f7-4678-bd41-202ad6b8488b"