> ## 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.

# Convert to WAV Format

> Convert existing music tracks to high-quality WAV format.

### Usage Guide

* Provide either taskId or audioId to identify the source track
* WAV format is ideal for professional audio editing and production
* The conversion preserves full audio quality

### Developer Notes

1. Generated WAV files are retained for 15 days
2. WAV files are significantly larger than MP3 files
3. This format is recommended for further audio processing or professional use
4. Callback provides a single download URL when conversion is complete


## OpenAPI

````yaml suno-api/suno-api.json POST /api/v1/wav/generate
openapi: 3.0.0
info:
  title: intro
  description: API documentation for audio generation services
  version: 1.0.0
  contact:
    name: Technical Support
    email: support@api.box
servers:
  - url: https://apibox.erweima.ai
    description: API Server
security:
  - BearerAuth: []
tags:
  - name: Music Generation
    description: Endpoints for creating and managing music generation tasks
  - name: Lyrics Generation
    description: Endpoints for lyrics generation and management
  - name: WAV Conversion
    description: Endpoints for converting music to WAV format
  - name: Vocal Removal
    description: Endpoints for vocal removal from music tracks
  - name: Music Video Generation
    description: Endpoints for generating MP4 videos from music tracks
  - name: Account Management
    description: Endpoints for account and credits management
paths:
  /api/v1/wav/generate:
    post:
      summary: Convert to WAV Format
      operationId: convert-to-wav-format
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - taskId
                - audioId
                - callBackUrl
              properties:
                taskId:
                  type: string
                  description: 'The task ID of the music generation task. '
                  example: 5c79****be8e
                audioId:
                  type: string
                  description: >-
                    The audio ID of the specific track to convert.  

                    - Providing the specific `audioId` ensures the exact track
                    is converted, especially when a task has multiple tracks.
                  example: e231****-****-****-****-****8cadc7dc
                callBackUrl:
                  type: string
                  format: uri
                  description: >-
                    The URL to receive WAV conversion completion notification.  

                    - Required.  

                    - The callback includes a single download URL for the
                    converted WAV file.

                    - For detailed callback format and implementation guide, see
                    [WAV Format Conversion
                    Callbacks](https://docs.api.box/suno-api/convert-to-wav-format-callbacks)

                    - Alternatively, you can use the Get WAV Conversion Details
                    interface to poll task status
                  example: https://api.example.com/callback
      responses:
        '200':
          description: Request successful
          content:
            application/json:
              schema:
                allOf:
                  - type: object
                    properties:
                      code:
                        type: integer
                        enum:
                          - 200
                          - 400
                          - 401
                          - 404
                          - 405
                          - 409
                          - 413
                          - 429
                          - 430
                          - 455
                          - 500
                        description: >-
                          # Status Codes


                          - ✅ 200 - Request successful

                          - ⚠️ 400 - Invalid parameters

                          - ⚠️ 401 - Unauthorized access

                          - ⚠️ 404 - Invalid request method or path

                          - ⚠️ 405 - Rate limit exceeded

                          - ⚠️ 409 - Conflict - WAV record already exists

                          - ⚠️ 413 - Theme or prompt too long

                          - ⚠️ 429 - Insufficient credits

                          - ⚠️ 430 - Your call frequency is too high. Please try
                          again later. 

                          - ⚠️ 455 - System maintenance

                          - ❌ 500 - Server error
                      msg:
                        type: string
                        description: Error message when code != 200
                        example: success
                  - type: object
                    properties:
                      data:
                        type: object
                        properties:
                          taskId:
                            type: string
                            description: Task ID for tracking task status
                            example: 5c79****be8e
        '500':
          $ref: '#/components/responses/Error'
      callbacks:
        wavGenerated:
          '{$request.body#/callBackUrl}':
            post:
              description: >-
                System will call this callback when WAV format audio generation
                is complete.


                ### Callback Example

                ```json

                {
                  "code": 200,
                  "msg": "success",
                  "data": {
                    "audioWavUrl": "https://example.com/s/04e6****e727.wav",
                    "task_id": "988e****c8d3"
                  }
                }

                ```
              requestBody:
                content:
                  application/json:
                    schema:
                      type: object
                      properties:
                        code:
                          type: integer
                          description: Status code
                          example: 200
                        msg:
                          type: string
                          description: Response message
                          example: success
                        data:
                          type: object
                          properties:
                            task_id:
                              type: string
                              description: Task ID
                            audioWavUrl:
                              type: string
                              description: WAV format audio file URL
              responses:
                '200':
                  description: Callback received successfully
              method: post
              type: path
            path: '{$request.body#/callBackUrl}'
components:
  responses:
    Error:
      description: Server error
  securitySchemes:
    BearerAuth:
      type: http
      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://api.box/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

````