> ## 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 Get Vox

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

## Overview

Use this endpoint to call the Suno Get Vox 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-get-vox.openapi.json POST /suno/act/vox/{clip_id}
openapi: 3.1.0
info:
  title: Get Vox API
  version: 1.0.0
servers:
  - url: https://api.deerapi.com
security:
  - bearerAuth: []
paths:
  /suno/act/vox/{clip_id}:
    post:
      summary: Get vox
      operationId: get_vox
      parameters:
        - name: clip_id
          in: path
          required: true
          description: ''
          schema:
            type: string
        - name: Content-Type
          in: header
          required: false
          description: ''
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - clip_id
              properties:
                clip_id:
                  type: string
                  default: example
              default:
                clip_id: example
            examples:
              Example 1:
                summary: Example 1
                value:
                  clip_id: 29e72f69-f535-4e17-8695-72fef7f167b9
            example:
              clip_id: 29e72f69-f535-4e17-8695-72fef7f167b9
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                required:
                  - id
                  - source_clip_id
                  - status
                  - vocal_audio_url
                  - vocal_end_s
                  - vocal_start_s
                  - wave_response
                properties:
                  id:
                    type: string
                  source_clip_id:
                    type: string
                  status:
                    type: string
                  vocal_audio_url:
                    type: string
                  vocal_end_s:
                    type: integer
                  vocal_start_s:
                    type: integer
                  wave_response:
                    type: object
                    required:
                      - waveform_aggregates
                    properties:
                      waveform_aggregates:
                        type: array
                        items:
                          type: object
                          properties:
                            data:
                              type: array
                              items:
                                type: array
                                items:
                                  type: integer
                            mip_map_level:
                              type: integer
      x-codeSamples:
        - lang: Shell
          label: cURL
          source: |
            curl https://api.deerapi.com/suno/act/vox/clip_id-value \
              -H "Content-Type: application/json" \
              -H "Authorization: Bearer $DEERAPI_KEY" \
              -d '{
                "clip_id": "29e72f69-f535-4e17-8695-72fef7f167b9"
              }'
        - lang: Python
          label: requests
          source: |
            import os
            import requests

            url = "https://api.deerapi.com/suno/act/vox/clip_id-value"
            headers = {
                "Authorization": "Bearer " + os.environ["DEERAPI_KEY"],
                "Content-Type": "application/json",
            }
            payload = {
              "clip_id": "29e72f69-f535-4e17-8695-72fef7f167b9"
            }

            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/act/vox/clip_id-value", {
              method: "POST",
              headers: {
                Authorization: `Bearer ${process.env.DEERAPI_KEY}`,
                "Content-Type": "application/json",
              },
              body: JSON.stringify({
                "clip_id": "29e72f69-f535-4e17-8695-72fef7f167b9"
              }),
            });


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

````