Voice Persona 初始化

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"
}

POST

suno

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"

Voice Persona Voice Persona 完成