# Suno Voice 获取验证短句

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /api/v1/voice/validate-info:
    get:
      summary: Suno Voice 获取验证短句
      deprecated: false
      description: |
        查询 Suno Voice 任务的验证短句生成结果。

        ### 使用指南

        - 使用验证短句生成接口或重新生成接口返回的 `taskId` 查询。
        - 当任务状态为 `wait_validating` 时，读取 `validateInfo` 并让用户录制该短句。
        - 如果任务失败，请根据 `errorCode` 和 `errorMessage` 判断是否重试。

        ### 状态说明

        | 状态 | 含义 |
        | --- | --- |
        | `wait_processing` | 任务等待处理中 |
        | `processing_validate` | 正在生成验证短句 |
        | `processing_validate_fail` | 验证短句生成失败 |
        | `wait_validating` | 短句已生成，等待用户录制验证音频验证 |
        | `success` | 完整音色创建流程已完成 |
        | `fail` | 任务失败 |

        ### 下一步

        <Card
        title="生成音色"
        icon="lucide-mic"
        href="/cn/suno-api/suno-voice-generate"
        >
        提交验证音频并创建最终自建音色
        </Card>
      operationId: suno-voice-validate-info
      tags:
        - docs/zh-CN/Suno API/Suno Voice
      parameters:
        - name: taskId
          in: query
          description: 任务id
          required: false
          schema:
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                  msg:
                    type: string
                  data:
                    type: object
                    properties:
                      taskId:
                        type: string
                        description: 任务id
                      validateInfo:
                        type: string
                        description: 验证短句文本
                      status:
                        type: string
                        description: 任务状态
                        enum:
                          - wait_processing
                          - processing_validate
                          - processing_validate_fail
                          - wait_validating
                          - success
                          - fail
                      errorCode:
                        type: integer
                        description: 错误码，任务失败时返回。
                      errorMessage:
                        type: string
                        description: 错误信息，任务失败时返回。
                    required:
                      - taskId
                      - validateInfo
                      - status
                      - errorCode
                      - errorMessage
                    x-apidog-orders:
                      - taskId
                      - validateInfo
                      - status
                      - errorCode
                      - errorMessage
                required:
                  - code
                  - msg
                  - data
                x-apidog-orders:
                  - code
                  - msg
                  - data
              example:
                code: 200
                msg: success
                data:
                  taskId: xxx_task_id_xxx
                  validateInfo: Harmonies fill the air with joyful melodies tonight
                  status: >-
                    wait_processing,processing_validate:等待验证码,processing_validate_fail:获取验证码失败,wait_validating:等待验证，success,fail
                  errorCode: 500
                  errorMessage: xxxxx
          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-46842377-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: []

```
