转换与角色

本页涵盖的是将已上传或已完成的音频进行转换的路由，而不是从零开始创建全新歌曲。

转换路由

路由	用途
`POST /suno/upload-cover`	上传音频并创建 AI 翻唱
`POST /suno/upload-extend`	上传音频并续写它
`POST /suno/add-vocals`	为伴奏添加人声
`POST /suno/add-instrumental`	为人声添加伴奏
`POST /suno/generate-persona`	从已完成的歌曲中创建可复用的声音身份
`POST /suno/vocal-removal`	分离人声和伴奏，或生成多轨音轨分轨
`POST /suno/wav-generate`	将已完成的歌曲导出为 WAV
`POST /suno/mp4-generate`	从已完成的歌曲创建音乐视频

`/suno/upload-cover`

这是将现有歌曲转换为 AI 翻唱的核心路由。

curl -X POST "https://api.anyint.ai/suno/upload-cover" \
  -H "Authorization: Bearer $ANYINT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "uploadUrl": "https://your-storage.com/song.mp3",
    "customMode": true,
    "instrumental": false,
    "model": "V5",
    "title": "Cover Version",
    "style": "R&B, soul",
    "personaId": "your-persona-id",
    "callBackUrl": "https://your-domain.com/callback"
  }'

Persona 工作流

当你希望在多个生成或翻唱任务中复用同一个人声身份时，请创建 persona。

`/suno/generate-persona`

curl -X POST "https://api.anyint.ai/suno/generate-persona" \
  -H "Authorization: Bearer $ANYINT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskId": "your-task-id",
    "audioId": "your-audio-id",
    "name": "Warm Female Voice A",
    "description": "适合情感流行的温暖中低音女性人声",
    "vocalStart": 10,
    "vocalEnd": 30
  }'

注意：

每个 audioId 只能创建一个 persona
persona 提取仅支持 V4 及更高版本
返回的 personaId 可在后续的 /suno/generate 和 /suno/upload-cover 调用中复用

人声与伴奏转换

`/suno/add-vocals`

当你有一条伴奏轨道并希望在其上添加 AI 人声时，请使用此路由。

`/suno/add-instrumental`

当你只有人声轨道并希望生成与之匹配的伴奏时，请使用此路由。

使用以下路由进行分轨： `/suno/vocal-removal`

此路由支持两种模式：

separate_vocal：将人声和伴奏分成两轨
split_stem：多轨分离，适用于更细致的制作流程

curl -X POST "https://api.anyint.ai/suno/vocal-removal" \
  -H "Authorization: Bearer $ANYINT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskId": "your-task-id",
    "audioId": "your-audio-id",
    "type": "separate_vocal",
    "callBackUrl": "https://your-domain.com/callback"
  }'

在双轨模式下，回调会返回 vocalUrl 和 instrumentalUrl。在多轨模式下，回调可能返回鼓、贝斯、吉他、键盘、弦乐、合成器和和声人声等分轨 URL。

导出路由

`/suno/wav-generate`

使用此路由可从已完成的音乐任务创建无损 WAV 导出。

`/suno/mp4-generate`

使用此路由可为已完成的歌曲任务创建音乐视频，以及 audioId.

On this page