> ## 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 任务重新生成验证短句。

### 使用指南

* 当之前的验证短句失败、过期，或用户需要新的短句时使用此接口。
* 提交音色验证流程中已有的 `taskId`。
* API 源数据中回调地址字段名为 `calBackUrl`。系统会在重新生成的验证短句完成或任务失败时发送 POST 回调。回调地址必须可公网访问，并在 15 秒内返回 HTTP 200。
* 使用返回的 `taskId` 再次查询新的验证短句结果。

### 流程

1. 提交已有验证任务 ID。
2. 保存接口返回的 `taskId`。
3. 通过查询接口或回调等待重新生成的 `validateInfo`。
4. 让用户录制新的验证短句，并将验证音频提交到音色生成接口。为获得更佳的音色生成效果，建议采用演唱方式录制。

### 回调

<Card title="重新生成验证短句回调" icon="lucide-webhook" href="/cn/suno-api/suno-voice-regenerate-callbacks">
  查看重新生成验证短句完成或失败时发送的回调格式
</Card>

### 开发者注意事项

* 请确保重新生成的短句和后续验证录音属于同一个任务流程。
* 如果短句反复生成失败，建议选择更清晰的人声片段并重新开始验证步骤。


## OpenAPI

````yaml /cn/suno-api/suno-voice-api-cn.json POST /api/v1/voice/regenerate
openapi: 3.0.1
info:
  title: Suno Voice API
  description: Suno Voice 自建音色 API 文档
  version: 1.0.0
  contact:
    name: Technical Support
    email: support@api.box
servers: []
security:
  - BearerAuth: []
tags:
  - name: docs
  - name: docs/zh-CN
  - name: docs/zh-CN/Market
  - name: docs/zh-CN/Market/Suno API
  - name: docs/zh-CN/Market/Suno API/voice
  - name: suno接口/voice
paths:
  /api/v1/voice/regenerate:
    post:
      tags:
        - docs/zh-CN/Market/Suno API/voice
        - suno接口/voice
      summary: Suno Voice 重新生成验证短句
      description: >
        为已有的 Suno Voice 任务重新生成验证短句。


        当之前的验证短句生成失败、已过期，或用户需要重新录制新的短句时，可以使用此接口。提交已有的 `taskId`
        后，系统会启动新的验证短句生成任务，并返回用于轮询的新任务 ID。


        ## 查询任务状态


        提交重新生成任务后，通过验证短句查询接口获取新的验证短句结果：


        <Card
          title="获取验证短句"
          icon="lucide-search"
          href="/cn/suno-api/suno-voice-validate-info"
        >
          了解如何查询重新生成的验证短句任务状态
        </Card>


        ## 继续流程


        新的验证短句生成完成后，请让用户录制该短句，并将验证音频提交到音色生成接口。为获得更佳的音色生成效果，建议采用演唱方式录制。


        <Card
          title="生成音色"
          icon="lucide-mic"
          href="/cn/suno-api/suno-voice-generate"
        >
          使用新录制的验证音频继续自建音色生成流程
        </Card>


        相关资源


        <CardGroup cols={2}>
          <Card title="生成验证短句" icon="lucide-file-audio" href="/cn/suno-api/suno-voice-validate"> 从源音频开始验证短句流程 </Card>
          <Card title="获取音色记录" icon="lucide-list-checks" href="/cn/suno-api/suno-voice-record-info"> 查询最终的自建音色生成结果 </Card>
        </CardGroup>
      operationId: suno-voice-regenerate
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                taskId:
                  description: 任务id
                  type: string
                calBackUrl:
                  type: string
                  description: >-
                    用于接收重新生成验证短句结果的回调地址。注意：该接口字段名为
                    `calBackUrl`。新的验证短句生成完成（`status:
                    wait_validating`）或任务失败时，系统会向该地址发送 POST 请求。该地址必须可公网访问，并在 15
                    秒内返回 HTTP 200。回调数据格式请参考
                    [重新生成验证短句回调](https://docs.api.box/cn/suno-api/suno-voice-regenerate-callbacks)。
              required:
                - taskId
                - calBackUrl
            example:
              taskId: xxxxxxx
              calBackUrl: https://example.com/callback/suno/voice_regenerate
        required: true
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                  msg:
                    type: string
                  data:
                    type: object
                    properties:
                      taskId:
                        type: string
                    required:
                      - taskId
                required:
                  - code
                  - msg
                  - data
              example:
                code: 200
                msg: success
                data:
                  taskId: xxx_task_id_xxx
          headers: {}
      deprecated: false
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: |-
        # API 认证说明

        所有接口都需要通过 Bearer Token 方式进行认证。

        ## 获取 API Key

        1. 访问 [API Key 管理页面](https://api.box/api-key) 获取您的 API Key

        ## 使用方式

        在请求头中添加：

        ```
        Authorization: Bearer YOUR_API_KEY
        ```

        > **注意：**
        > - 请妥善保管您的 API Key，不要泄露给他人
        > - 如果怀疑 API Key 泄露，请立即在管理页面重置

````