> ## Documentation Index
> Fetch the complete documentation index at: https://docs.api.box/llms.txt
> Use this file to discover all available pages before exploring further.

# Suno Voice 重新生成验证短句回调

> 重新生成 Suno Voice 验证短句完成或失败时，通过 POST 回调接收结果。

提交重新生成验证短句任务时，请使用 API 源数据中的 `calBackUrl` 字段传入回调地址。系统会在新的验证短句生成完成或任务失败时发送 POST 请求。

## 回调机制概述

<Info>
  重新生成验证短句回调与首次生成验证短句回调使用相同的数据结构。
</Info>

### 回调时机

* 新的验证短句生成完成，等待用户录制验证音频
* 验证短句重新生成失败
* 任务处理过程中发生错误

### 回调方式

* **HTTP 方法**：POST
* **Content Type**：application/json
* **超时时间**：15 秒

## 回调请求格式

<CodeGroup>
  ```json 重新生成验证短句完成回调 theme={null}
  {
    "code": 200,
    "msg": "success",
    "data": {
      "taskId": "xxx_task_id_xxx",
      "validateInfo": "请清晰录制这段新的验证短句。",
      "status": "wait_validating",
      "errorCode": 0,
      "errorMessage": ""
    }
  }
  ```

  ```json 重新生成验证短句失败回调 theme={null}
  {
    "code": 400,
    "msg": "Validation phrase regeneration failed",
    "data": {
      "taskId": "xxx_task_id_xxx",
      "validateInfo": "",
      "status": "processing_validate_fail",
      "errorCode": 500,
      "errorMessage": "Failed to regenerate validation phrase"
    }
  }
  ```
</CodeGroup>

## 字段说明

<ParamField path="code" type="integer" required>
  回调状态码。`200` 表示成功，非 200 表示任务失败或处理异常。
</ParamField>

<ParamField path="msg" type="string" required>
  回调状态消息。
</ParamField>

<ParamField path="data.taskId" type="string" required>
  重新生成验证短句接口返回的任务 ID。
</ParamField>

<ParamField path="data.validateInfo" type="string">
  重新生成的验证短句文本。当 `status` 为 `wait_validating` 时返回。
</ParamField>

<ParamField path="data.status" type="string" required>
  任务状态。常见回调状态包括 `wait_validating`、`processing_validate_fail` 和 `fail`。
</ParamField>

<ParamField path="data.errorCode" type="integer">
  任务失败时返回的错误码。
</ParamField>

<ParamField path="data.errorMessage" type="string">
  任务失败时返回的详细错误信息。
</ParamField>

## 相关接口

<Card title="获取验证短句" icon="lucide-search" href="/cn/suno-api/suno-voice-validate-info">
  使用 taskId 手动查询重新生成的验证短句
</Card>