Suno Voice 自建音色生成回调

自建音色创建成功时，回调中会包含生成的 voiceId。

回调请求格式

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "xxx_task_id_xxx",
    "voiceId": "voice_xxx",
    "status": "success",
    "errorCode": 0,
    "errorMessage": ""
  }
}

{
  "code": 400,
  "msg": "Voice generation failed",
  "data": {
    "taskId": "xxx_task_id_xxx",
    "voiceId": "",
    "status": "fail",
    "errorCode": 500,
    "errorMessage": "Verification audio did not match the validation phrase"
  }
}

字段说明

integer

必填

回调状态码。200 表示成功，非 200 表示任务失败或处理异常。

string

必填

回调状态消息。

string

必填

自建音色生成接口返回的任务 ID。

string

生成的自建音色 ID。当 status 为 success 时返回。

string

必填

任务状态。常见回调状态包括 success、processing_validate_fail 和 fail。

integer

任务失败时返回的错误码。

string

任务失败时返回的详细错误信息。

接收回调示例

Node.js

const express = require('express');
const app = express();

app.use(express.json());

app.post('/suno/voice-generate-callback', (req, res) => {
  const { code, msg, data } = req.body;

  if (code === 200 && data.status === 'success') {
    console.log('自建音色已生成:', data.voiceId);
  } else {
    console.error('自建音色任务失败:', msg, data.errorMessage);
  }

  res.status(200).json({ status: 'received' });
});

app.listen(3000);

Generate Music

Suno Voice

Lyrics Generation

Generate Sounds

WAV Conversion

Vocal Removal

Music Video Generation

Account Management

文件上传API

Suno Voice 自建音色生成回调

回调机制概述

回调时机

回调方式

回调请求格式

字段说明

接收回调示例

相关接口

获取自建音色记录

​回调机制概述

​回调时机

​回调方式

​回调请求格式

​字段说明

​接收回调示例

​相关接口

获取自建音色记录

回调机制概述

回调时机

回调方式

回调请求格式

字段说明

接收回调示例

相关接口