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

# Music Cover Preprocess

> Preprocess reference audio to extract features and lyrics for two-step cover generation.



## OpenAPI

````yaml POST /v1/music_cover_preprocess
openapi: 3.1.0
info:
  title: MiniMax Music Generation API
  description: >-
    MiniMax music generation API with support for creating music from text
    prompts and lyrics
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.minimax.io
security:
  - bearerAuth: []
paths:
  /v1/music_cover_preprocess:
    post:
      tags:
        - Music
      summary: Music Cover Preprocess
      operationId: coverPreprocess
      parameters:
        - name: Content-Type
          in: header
          required: true
          description: >-
            The media type of the request body. Must be set to
            `application/json` to ensure the data is sent in JSON format.
          schema:
            type: string
            enum:
              - application/json
            default: application/json
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CoverPreprocessReq'
        required: true
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CoverPreprocessResp'
components:
  schemas:
    CoverPreprocessReq:
      type: object
      required:
        - model
      properties:
        model:
          type: string
          description: Model name. Must be `music-cover`.
          enum:
            - music-cover
        audio_url:
          type: string
          description: >-
            URL of the reference audio. Exactly one of `audio_url` or
            `audio_base64` must be provided.


            Reference audio constraints:

            - Duration: 6 seconds to 6 minutes

            - Size: max 50 MB

            - Format: common audio formats (mp3, wav, flac, etc.)
        audio_base64:
          type: string
          description: >-
            Base64-encoded reference audio. Exactly one of `audio_url` or
            `audio_base64` must be provided.


            Reference audio constraints:

            - Duration: 6 seconds to 6 minutes

            - Size: max 50 MB

            - Format: common audio formats (mp3, wav, flac, etc.)
      example:
        model: music-cover
        audio_url: https://example.com/song.mp3
    CoverPreprocessResp:
      type: object
      properties:
        cover_feature_id:
          type: string
          description: >-
            Unique identifier for the preprocessed audio features. Valid for 24
            hours. Pass this to the [Music Generation
            API](/api-reference/music-generation) `cover_feature_id` parameter
            for two-step cover generation.


            Same audio content returns the same `cover_feature_id` (MD5-based
            deduplication).
        formatted_lyrics:
          type: string
          description: >-
            Structured lyrics extracted from the reference audio via ASR,
            formatted with section tags such as `[Verse]`, `[Chorus]`,
            `[Bridge]`, etc. You can modify these lyrics before passing them to
            the Music Generation API.
        structure_result:
          type: string
          description: >-
            JSON string containing the song structure analysis result, including
            segment types (`intro`, `verse`, `chorus`, `bridge`, `outro`,
            `inst`, `silence`) and their start/end timestamps in seconds.
        audio_duration:
          type: number
          format: double
          description: Duration of the reference audio in seconds.
        trace_id:
          type: string
          description: Unique trace ID for request tracking.
        base_resp:
          $ref: '#/components/schemas/BaseResp'
      example:
        cover_feature_id: a1b2c3d4e5f67890abcdef1234567890
        formatted_lyrics: |-
          [Verse 1]
          First line of the song
          Second line continues

          [Chorus]
          This is the chorus
          Singing out loud
        structure_result: >-
          {"num_segments":4,"segments":[{"start":0,"end":15.5,"label":"intro"},{"start":15.5,"end":45.2,"label":"verse"},{"start":45.2,"end":75.0,"label":"chorus"},{"start":75.0,"end":90.0,"label":"outro"}]}
        audio_duration: 90
        trace_id: 061e5f144eb7f10b1fdde81126e24f91
        base_resp:
          status_code: 0
          status_msg: success
    BaseResp:
      type: object
      description: Status code and details
      properties:
        status_code:
          type: integer
          description: >-
            Status codes and their meanings:


            `0`: Success


            `1002`: Rate limit triggered, retry later


            `1004`: Authentication failed, check API Key


            `1008`: Insufficient balance


            `1026`: Content flagged for sensitive material


            `2013`: Invalid parameters, check input


            `2049`: Invalid API Key


            For more information, please refer to the [Error Code
            Reference](/api-reference/errorcode).
        status_msg:
          type: string
          description: Detailed error message
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        `HTTP: Bearer Auth`

        - Security Scheme Type: http

        - HTTP Authorization Scheme: `Bearer API_key`, can be found in [Account
        Management>API
        Keys](https://platform.minimax.io/user-center/basic-information/interface-key).

````