> ## 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 自建音色流程所需的验证短句。

### 使用指南

* 提交源录音 URL，以及用于创建音色的人声片段范围。
* 接口会返回 `taskId`，后续可用它查询生成的验证短句。
* 如果传入 `callBackUrl`，系统会在验证短句生成完成或任务失败时发送 POST 回调。回调地址必须可公网访问，并在 15 秒内返回 HTTP 200。
* 获取 `validateInfo` 后，让用户录制该短句并上传验证音频，再调用音色生成接口。为获得更佳的音色生成效果，建议采用演唱方式录制。

### 流程

1. 上传或托管源音频，确保 `voiceUrl` 可公开访问。
2. 使用 `vocalStartS` 和 `vocalEndS` 选择干净的人声片段。
3. 提交验证短句任务，并保存返回的 `taskId`。
4. 通过查询接口或回调等待 `validateInfo`。
5. 录制用户完成验证短句的音频，然后调用自建音色生成接口。为获得更佳的音色生成效果，建议采用演唱方式录制。

### 回调

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

### 开发者注意事项

* `vocalEndS` 必须大于 `vocalStartS`。
* 建议选择人声清晰、背景噪音少的片段，以提高验证效果。
* `language` 用于控制验证短句语言，支持 `en`、`zh`、`es`、`fr`、`pt`、`de`、`ja`、`ko`、`hi`、`ru`。


## OpenAPI

````yaml /cn/suno-api/suno-voice-api-cn.json POST /api/v1/voice/validate
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/validate:
    post:
      tags:
        - docs/zh-CN/Market/Suno API/voice
        - suno接口/voice
      summary: Suno Voice生成验证短句接口
      description: |
        生成 Suno Voice 自建音色流程所需的验证短句。

        提交源音频 URL 和已选择的人声片段。系统会分析源音频中的声音，并生成一段用户后续需要录制的验证短句。

        ## 查询任务状态

        提交任务后，你可以通过验证短句查询接口检查任务进度，并获取生成的验证短句：

        <Card
          title="获取验证短句"
          icon="lucide-search"
          href="/cn/suno-api/suno-voice-validate-info"
        >
          了解如何查询验证短句任务状态，并获取用户需要录制的短句
        </Card>

        :::tip[]
        生产环境中，建议使用 `callBackUrl` 参数在验证短句生成完成后接收自动通知，而不是轮询状态接口。
        :::

        ## 下一步

        验证短句生成完成后，请让用户录制该短句并上传验证音频，以继续创建自建音色。为获得更佳的音色生成效果，建议采用演唱方式录制。

        <Card
          title="生成音色"
          icon="lucide-mic"
          href="/cn/suno-api/suno-voice-generate"
        >
          提交验证音频并生成最终的自建音色
        </Card>

        相关资源

        <CardGroup cols={2}>
          <Card title="重新生成验证短句" icon="lucide-refresh-cw" href="/cn/suno-api/suno-voice-regenerate"> 为已有任务重新生成验证短句 </Card>
          <Card title="通用 API" icon="lucide-cog" href="/cn/suno-api/get-remaining-credits"> 查看账户积分和使用情况 </Card>
        </CardGroup>
      operationId: suno-voice-validate
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                voiceUrl:
                  description: 用户上传的原始录音URL[必填]
                  type: string
                vocalStartS:
                  description: 截取人声开始秒数[必填]
                  type: integer
                vocalEndS:
                  description: 截取人声结束秒数，必须大于vocal_start_s[必填]
                  type: integer
                language:
                  description: >-
                    验证短句语言,支持的语言有:
                    en英文，zh中文，es西班牙语，fr法语，pt葡萄牙语言，de德语，ja日语，ko韩语，hi印地语，ru俄语
                  type: string
                callBackUrl:
                  description: >-
                    用于接收验证短句生成结果的回调地址。验证短句生成完成（`status:
                    wait_validating`）或任务失败时，系统会向该地址发送 POST 请求。该地址必须可公网访问，并在 15
                    秒内返回 HTTP 200。回调数据格式请参考
                    [验证短句回调](https://docs.api.box/cn/suno-api/suno-voice-validate-callbacks)。
                  type: string
              required:
                - voiceUrl
                - vocalStartS
                - vocalEndS
            example:
              voiceUrl: https://example.com/audio/user_voice.mp3
              vocalStartS: 0
              vocalEndS: 10
              language: en
              callBackUrl: https://example.com/callback/suno/voice_prepare
        required: true
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                  msg:
                    type: string
                  data:
                    type: object
                    properties:
                      taskId:
                        description: 任务id
                        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 泄露，请立即在管理页面重置

````