Suno Voice获取自建音色记录

GET

/api/v1/voice/record-info

查询 Suno Voice 自建音色生成结果。

使用音色生成接口返回的 taskId 调用此接口。当任务成功后，响应中会包含 voiceId，该值可作为自建音色 ID 用于支持该能力的生成接口。

状态处理

根据 status 字段判断下一步操作：

wait_processing、processing_validate 或 wait_validating：任务仍在处理中

success：音色已准备完成，可以使用 voiceId 进行后续生成

processing_validate_fail 或 fail：任务失败，请查看 errorMessage 获取失败原因

音色可用性

获取 voiceId 后，可以使用音色可用性检查接口确认该音色是否可以使用：

检查音色是否可用

检查该任务生成的自建音色是否可用

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Query Params

Responses

🟢200

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.kie.ai/api/v1/voice/record-info?taskId=undefined' \
--header 'Authorization: Bearer <token>'

Response Example

{
    "code": 200,
    "msg": "success",
    "data": {
        "taskId": "xxx_task_id_xxx",
        "voiceId": "xxx",
        "status": "wait_processing,processing_validate:等待验证码,processing_validate_fail:获取验证码失败,wait_validating:等待验证，success,fail",
        "errorCode": 500,
        "errorMessage": "xxxxx"
    }
}

Suno Voice自建音色生成接口

Suno Voice 重新生成验证短句

Suno Voice获取自建音色记录

状态处理#

音色可用性#

Request

Responses

状态处理

音色可用性