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

# Suno Voice Verify

> Use DeerAPI to call the Suno Voice Verify endpoint with request details, response details, examples, and an OpenAPI playground.

## Overview

Use this endpoint to call the Suno Voice Verify workflow through DeerAPI. The API reference on this page shows the request schema, response schema, authentication requirements, and runnable examples for the configured endpoint.

## Before you start

Use the DeerAPI base URL and pass your API Key in the `Authorization` header:

```text theme={null}
https://api.deerapi.com
```

```text theme={null}
Authorization: Bearer $DEERAPI_KEY
```

## Model selection

Choose a current model ID from the [live pricing page](https://api.deerapi.com/pricing). Model availability changes over time, so avoid copying a model ID from an old project without checking the live list first.

## Implementation notes

* Use the OpenAPI playground for the exact request fields accepted by this endpoint.
* Keep API Keys on the server side when you build production applications.
* Log the request ID from failed calls so support can investigate the request.
* Retry `429`, `500`, and `503` responses with exponential backoff.


## OpenAPI

````yaml /api/openapi/music/suno/post-voice-verify.openapi.json POST /suno/persona/voice/verify
openapi: 3.1.0
info:
  title: Voice Verification API
  version: 1.0.0
servers:
  - url: https://api.deerapi.com
security:
  - bearerAuth: []
paths:
  /suno/persona/voice/verify:
    post:
      summary: Voice verification
      operationId: voice_verify
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - url
                - phrase_id
                - voice_recording_id
              properties:
                url:
                  type: string
                  description: >-
                    URL of the recorded verification audio matching phrase_text.
                    Supports .mp3 or .wav.
                phrase_id:
                  type: string
                  description: phrase_id from the get verification phrase step
                voice_recording_id:
                  type: string
                  description: voice_recording_id from the upload voice step
            examples:
              Example 1:
                summary: Example 1
                value:
                  url: >-
                    https://cdn1.suno.ai/28fc2b84-07d3-45d7-85f3-3db6684801aa.mp3
                  phrase_id: 45d639aa-ad8a-41cd-a356-f81207491d3a
                  voice_recording_id: 575023b1-b071-4dbd-9f0d-176665c60768
            example:
              url: https://cdn1.suno.ai/28fc2b84-07d3-45d7-85f3-3db6684801aa.mp3
              phrase_id: 45d639aa-ad8a-41cd-a356-f81207491d3a
              voice_recording_id: 575023b1-b071-4dbd-9f0d-176665c60768
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: verification_id for use in the create persona step
                  status:
                    type: string
                    description: Verification status. approved means passed.
      x-codeSamples:
        - lang: Shell
          label: cURL
          source: |
            curl https://api.deerapi.com/suno/persona/voice/verify \
              -H "Content-Type: application/json" \
              -H "Authorization: Bearer $DEERAPI_KEY" \
              -d '{
                "url": "https://cdn1.suno.ai/28fc2b84-07d3-45d7-85f3-3db6684801aa.mp3",
                "phrase_id": "45d639aa-ad8a-41cd-a356-f81207491d3a",
                "voice_recording_id": "575023b1-b071-4dbd-9f0d-176665c60768"
              }'
        - lang: Python
          label: requests
          source: |
            import os
            import requests

            url = "https://api.deerapi.com/suno/persona/voice/verify"
            headers = {
                "Authorization": "Bearer " + os.environ["DEERAPI_KEY"],
                "Content-Type": "application/json",
            }
            payload = {
              "url": "https://cdn1.suno.ai/28fc2b84-07d3-45d7-85f3-3db6684801aa.mp3",
              "phrase_id": "45d639aa-ad8a-41cd-a356-f81207491d3a",
              "voice_recording_id": "575023b1-b071-4dbd-9f0d-176665c60768"
            }

            response = requests.post(url, headers=headers, json=payload)
            print(response.json())
        - lang: JavaScript
          label: fetch
          source: >
            const response = await
            fetch("https://api.deerapi.com/suno/persona/voice/verify", {
              method: "POST",
              headers: {
                Authorization: `Bearer ${process.env.DEERAPI_KEY}`,
                "Content-Type": "application/json",
              },
              body: JSON.stringify({
                "url": "https://cdn1.suno.ai/28fc2b84-07d3-45d7-85f3-3db6684801aa.mp3",
                "phrase_id": "45d639aa-ad8a-41cd-a356-f81207491d3a",
                "voice_recording_id": "575023b1-b071-4dbd-9f0d-176665c60768"
              }),
            });


            console.log(await response.json());
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Use a DeerAPI API Key as a Bearer token.

````