docs.api.box
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
Support
Suno API
Common API文件上传API
Suno API
Common API文件上传API
  1. Suno Voice
  • API.box 文档
  • 快速开始
  • Generate Music
    • 音乐生成回调
    • 音乐延长回调
    • 上传并翻唱音频回调
    • 上传并扩展音频回调
    • 添加伴奏回调
    • 添加人声回调
    • 音乐封面生成回调
    • 替换音乐分区回调
    • 生成音乐
      POST
    • 延长音乐
      POST
    • 上传并翻唱音乐
      POST
    • 上传并扩展音乐
      POST
    • 添加伴奏
      POST
    • 添加人声
      POST
    • 获取音乐生成详情
      GET
    • 恢复音频
      POST
    • 获取恢复音频详情
      GET
    • 获取带时间戳的歌词
      POST
    • 提升音乐风格
      POST
    • 生成音乐封面
      POST
    • 替换音乐分区
      POST
    • 获取音乐封面详情
      GET
    • 生成 Persona
      POST
    • 混音生成
      POST
  • Suno Voice
    • Suno Voice 验证短句回调
    • Suno Voice 自建音色生成回调
    • Suno Voice 重新生成验证短句回调
    • Suno Voice 生成验证短句
      POST
    • Suno Voice 获取验证短句
      GET
    • Suno Voice 自建音色生成
      POST
    • Suno Voice 获取自建音色记录
      GET
    • Suno Voice 重新生成验证短句
      POST
    • Suno Voice 检查音色是否可用
      POST
  • Lyrics Generation
    • 歌词生成回调
    • 生成歌词
    • 获取歌词生成详情
  • Generate Sounds
    • 生成声音
  • WAV Conversion
    • WAV格式转换回调
    • 转换为WAV格式
    • 获取WAV转换详情
  • Vocal Removal
    • 音频分离回调
    • MIDI 生成回调
    • 人声与乐器分离
    • 获取音频分离详情
    • 从音频生成 MIDI
    • 获取 MIDI 生成详情
  • Music Video Generation
    • 音乐视频生成回调
    • 创建音乐视频
    • 获取音乐视频详情
  • Generate Speech
    • 生成语音
  1. Suno Voice

Suno Voice 自建音色生成

POST
/api/v1/voice/generate
根据用户录制的验证短句音频生成可复用的 Suno 自建音色。

使用指南#

请在验证短句生成完成,并且用户已完成验证音频录制后调用此接口。
验证短句是服务端返回的 validateInfo 文本。为获得更佳的音色生成效果,建议用户以演唱方式录制服务端返回的验证短句。
提交原验证任务的 taskId,并在 verifyUrl 中传入验证音频 URL。
可选的 voiceName、description、style 和 singerSkillLevel 可帮助管理并调整生成的音色。
接口会返回新的 taskId,后续通过它查询最终 voiceId。
如果传入 callBackUrl,系统会在音色创建完成或任务失败时发送 POST 回调。回调地址必须可公网访问,并在 15 秒内返回 HTTP 200。

流程#

1.
生成并获取验证短句。
2.
录制用户完成该短句的验证音频;为获得更佳的音色生成效果,建议采用演唱方式录制。
3.
上传或托管验证音频,并将 URL 作为 verifyUrl 传入。
4.
提交音色生成任务,并保存返回的 taskId。
5.
任务成功后,通过查询接口或回调获取 voiceId。

回调#

自建音色生成回调
查看音色创建完成或失败时发送的回调格式

开发者注意事项#

taskId 必须来自同一音色流程中的验证短句任务。
verifyUrl 应指向用户录制服务端返回的同一条验证短句的音频;为获得更佳效果,建议采用演唱方式录制。
获取 voiceId 后,建议先调用音色可用性检查接口,再用于依赖自建音色的生成流程。

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 Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://apibox.erweima.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",
    "singerSkillLevel": "beginner",
    "callBackUrl": "https://example.com/callback/suno/voice_create"
}'
Response Response Example
{
    "code": 200,
    "msg": "success",
    "data": {
        "taskId": "xxx_task_id_xxx"
    }
}
Previous
Suno Voice 获取验证短句
Next
Suno Voice 获取自建音色记录
Built with