Skip to main content
POST
Clone Voice — create Voice Persona from audio_url
Clone Voice (POST /suno/v2/voices) is a Voice Persona API. It is the paid one-step equivalent of Init + Complete: one public audio_url, one task, same Voice Persona.
Billed. The Init + Complete path is free and produces the same Voice Persona. Failed Clone Voice tasks should not be billed. See Persona overview.
Phrase language is English only. On /generate set persona.is_voice: true and stay on the creating account.

Request

Create task

Returns { "taskId": "..." }. Poll Get Task Status until status is success.

Task result (data when success)

This is the real payload after Clone Voice finishes — use persona_id on /generate:

Authorizations

Authorization
string
header
required

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

Body

application/json
audio_url
string<uri>
required

公网可下载的参考音频 URL,MP3/WAV,时长 10240 秒,建议 3060 秒单人干声

Example:

"https://cdn.acedata.cloud/suno_demo.mp3"

name
string

音色名称;不传则由系统生成

Example:

"My Voice"

description
string

音色描述

Response

201 - application/json
taskId
string
required

task id. Use this id to query task status.

Example:

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