# Suno Voice 重新生成验证短句

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /api/v1/voice/regenerate:
    post:
      summary: Suno Voice 重新生成验证短句
      deprecated: false
      description: >
        为已有 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>


        ### 开发者注意事项


        - 请确保重新生成的短句和后续验证录音属于同一个任务流程。

        - 如果短句反复生成失败，建议选择更清晰的人声片段并重新开始验证步骤。
      operationId: suno-voice-regenerate
      tags:
        - docs/zh-CN/Suno API/Suno Voice
      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.sunoapi.org/cn/suno-api/suno-voice-regenerate-callbacks)。
              required:
                - taskId
                - calBackUrl
              x-apidog-orders:
                - taskId
                - calBackUrl
            example:
              taskId: xxxxxxx
              calBackUrl: https://example.com/callback/suno/voice_regenerate
      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
                    x-apidog-orders:
                      - taskId
                required:
                  - code
                  - msg
                  - data
                x-apidog-orders:
                  - code
                  - msg
                  - data
              example:
                code: 200
                msg: success
                data:
                  taskId: xxx_task_id_xxx
          headers: {}
          x-apidog-name: 成功
      security: []
      x-apidog-folder: docs/zh-CN/Suno API/Suno Voice
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/1412907/apis/api-46842381-run
components:
  schemas: {}
  securitySchemes:
    BearerAuth:
      type: bearer
      scheme: bearer
      bearerFormat: API Key
      description: >-
        # 🔑 API Authentication


        All endpoints require authentication using Bearer Token.


        ## Get API Key


        1. Visit the [API Key Management Page](https://sunoapi.org/api-key) to
        obtain your API Key


        ## Usage


        Add to request headers:


        ```

        Authorization: Bearer YOUR_API_KEY

        ```


        > **⚠️ Note:**

        > - Keep your API Key secure and do not share it with others

        > - If you suspect your API Key has been compromised, reset it
        immediately from the management page
servers:
  - url: https://apibox.erweima.ai
    description: 正式环境
security: []

```
