Suno Voice自建音色生成接口

POST

/api/v1/voice/generate

在用户录制验证短句后，生成 Suno Voice 自建音色。

提交原验证任务 ID、用户朗读验证短句后的音频 URL，以及可选的音色元信息，例如 voiceName、description 和 style。系统会验证录音并创建可复用的自建音色。

为了获得更佳效果，请上传或录制一段歌声样本。纯净的清唱人声通常能生成最准确的人声分析结果。

查询任务状态

提交任务后，你可以通过自建音色记录查询接口检查音色生成进度，并获取最终的 voiceId：

获取音色记录

了解如何查询自建音色生成状态，并获取生成的 voiceId

生产环境中，建议使用 callBackUrl 参数在自建音色生成完成后接收自动通知，而不是轮询状态接口。

使用生成的音色

当任务成功后，查询接口或回调结果中会包含 voiceId。你可以在支持自建音色的 Suno 生成接口中使用该 ID。

相关资源

检查音色是否可用

验证生成的音色是否可以使用

通用 API

查看账户积分和使用情况

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

or

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.kie.ai/api/v1/voice/generate' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "taskId": "voice_create_001",
    "verifyUrl": "https://example.com/audio/verify_read.mp3",
    "voiceName": "My Voice",
    "description": "created from uploaded voice",
    "style": "Pop, Female Vocal",
    "callBackUrl": "https://example.com/callback/suno/voice_create",
    "singerSkillLevel": "beginner"
}'

Response Example

{
    "code": 200,
    "msg": "success",
    "data": {
        "taskId": "xxx_task_id_xxx"
    }
}

Suno Voice获取验证短句接口

Suno Voice获取自建音色记录