跳转到主要内容
POST
create voice persona from audio (instant clone)
Clone Voice(POST /suno/v2/voices)属于 Voice Persona。它把 Init + Complete 的同一套官方流程收成一次异步任务:上传 → 人声分轨 → 短语 → TTS 校验 → 创建。 你只需传一条公网 audio_url。短语 / TTS 在服务端完成,没有二次录音界面。Init + Complete 不变,仍然免费。
收费。 Clone Voice 失败任务不应扣费。详见 Persona 总览。
/generate 时传 persona.persona_id + persona.is_voice: true。Voice Persona 的 artist_clip_id 可选(只传 persona_id 即可选到任务人声)。同账号 ById — 必须走创建时的账号。

请求

创建任务

返回 { "taskId": "..." }。用 获取任务状态 轮询,直到 status 为 success。

任务结果(成功时的 data)

抄下 persona_id。结果里也可能有 artist_clip_id — 后续 /generate 可选:

在 /generate 里使用

授权

Authorization
string
header
必填

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

请求体

application/json
audio_url
string<uri>
必填

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

示例:

"https://example.com/voice.mp3"

name
string

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

示例:

"My Voice"

description
string

音色描述

is_public
boolean
默认值:false

是否公开到官方 Suno。默认 false。true 时该声线会出现在官方广场。

示例:

false

vocal_start_s
number

人声区间起点(秒)。不传则官方自动检测,与旧平台 voices 一致。

示例:

0

vocal_end_s
number

人声区间终点(秒)。不传则官方自动检测,与旧平台 voices 一致。

示例:

30

响应

201 - application/json
taskId
string
必填

task id. Use this id to query task status.

示例:

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