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

# Suno File Download API Documentation

> Use the Suno file download API to retrieve music files in mp3, m4a, or wav for delivery, sharing, and downstream processing.

Download one or more audio formats for an existing Suno track. Supported formats: `mp3`, `m4a`, `wav`. The response returns download URLs for each requested format. Costs **0.2 quota**. See [Audio Pricing](/grids/en/start/pricing/audio#suno).

<Warning>
  **Billing caution:** Every successful call is billed at **0.2 quota**. Calling this endpoint again for the same `music_id` or file still incurs a new charge. Cache the returned download URLs and avoid duplicate requests.
</Warning>


## OpenAPI

````yaml openapi/en/suno.json POST /suno/v1/download
openapi: 3.1.0
info:
  title: TTAPI API DOCS
  version: 1.0.0
  description: Suno AI Music API
servers:
  - url: https://api.ttapi.io
security: []
paths:
  /suno/v1/download:
    post:
      description: Download music files in the specified formats (mp3, m4a, wav).
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                music_id:
                  type: string
                  description: Song ID
                  example: 518c74ee-62ac-4ccd-b3d9-7003acd12ad7
                formats:
                  type: array
                  description: 'Audio formats to download. Supported: mp3, m4a, wav.'
                  items:
                    type: string
                    enum:
                      - mp3
                      - m4a
                      - wav
                  example:
                    - wav
              required:
                - music_id
                - formats
      responses:
        '200':
          description: Request successful
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: SUCCESS
                  message:
                    type: string
                    example: success
                  data:
                    type: object
                    properties:
                      jobId:
                        type: string
                        description: Task ID
                        example: 3c092ede-342a-47f6-81df-4a0fdc5c1ec0
                      music_id:
                        type: string
                        description: Song ID
                        example: 518c74ee-62ac-4ccd-b3d9-7003acd12ad7
                      files:
                        type: array
                        description: Downloaded files for each requested format.
                        items:
                          type: object
                          properties:
                            format:
                              type: string
                              description: File format
                              example: wav
                            file_url:
                              type: string
                              description: Download URL for the file
                              example: >-
                                https://cdn.ttapi.io/suno/20260902/43e4a6989a0949468b84caf9f9a54a11.wav
                          required:
                            - format
                            - file_url
                    required:
                      - jobId
                      - music_id
                      - files
                required:
                  - status
                  - message
                  - data
        '400':
          $ref: '#/components/responses/400Response'
        '401':
          $ref: '#/components/responses/401Response'
      security:
        - CustomApiKey: []
components:
  responses:
    400Response:
      description: Parameter error
      content:
        application/json:
          schema:
            type: object
            properties:
              status:
                type: string
                example: FAILED
              message:
                type: string
              data:
                type: object
            required:
              - status
              - message
    401Response:
      description: Authorization failed
      content:
        application/json:
          schema:
            type: object
            properties:
              status:
                type: string
                example: FAILED
              message:
                type: string
                example: Wrong TT-API-KEY or email is not activated.
            required:
              - status
              - message
  securitySchemes:
    CustomApiKey:
      type: apiKey
      in: header
      name: TT-API-KEY
      description: >-
        You can obtain your API key from the <a
        href='https://dashboard.ttapi.io' target='_blank'>TTAPI Dashboard</a>.

````