Voice 与 Persona 流程

能力按服务端配置逐项启用。未启用操作返回 503 且不创建任务；音乐积分扣除当前未启用。

​

录音 Voice：四步

• 1. 提交 suno_voice_upload，传 voice_url 和 vocal_start_s/vocal_end_s，等待 ready:true。
• 2. POST /api/v1/voices/verification_phrase，传 voice_upload_task_id 和 language。此步骤选择验证短句语言，实际验证发生在第 3 步；再次调用可重取短句。
• 3. 本人朗读 phrase_text 并上传录音，以同一上传任务 ID、phrase_id 和 upload_url 提交 suno_voice_create，通过统一任务查询获得 voice_id。
• 4. GET /api/v1/voices/{voice_id} 检查当前可用性；供应商查询故障返回 503，不伪造成 available:false。

语言：en、zh、es、fr、pt、de、ja、ko、hi、ru，默认en。样本会话自成功准备后有效24小时，短句映射继承相同到期时间。expires_at:null仅表示供应商短句TTL未知，不代表永久有效；仅短句过期时重取短句，样本会话过期后须重新上传样本并从头验证。

​

复用已验证音色

{
  "model": "suno_generate",
  "input": {
    "model": "V6",
    "custom_mode": true,
    "instrumental": false,
    "title": "Paper boats at dawn",
    "style": "Fingerpicked guitar, gentle brushed drums",
    "lyrics": "[Verse]\nWe fold a map into a boat\nAnd let the morning carry it home",
    "persona_id": "YOUR_VOICE_ID",
    "persona_model": "voice_persona"
  }
}

​

从歌曲创建