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

# MUSIC AI V2

> Create music powered by AI using just a prompt, lyrics, or a defined music style.



## OpenAPI

````yaml POST /v2/MusicAI
openapi: 3.1.0
info:
  title: WAV API
  version: 1.0.0
  description: API for retrieving conversion details by ID.
servers:
  - url: https://api.wav.com/api/public
    description: Production server
security: []
paths:
  /v2/MusicAI:
    post:
      summary: Generate Custom Music
      description: >-
        Create music powered by AI using just a prompt, lyrics, or a defined
        music style.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                prompt:
                  type: string
                  description: >-
                    A natural language prompt for music generation. Keep it
                    under 300 characters. Be clear and descriptive for better
                    results.
                music_style:
                  type: string
                  description: Style of music to generate (e.g., Rock, Pop)
                  example: Lo-fi
                lyrics:
                  type: string
                  description: Custom lyrics for the generated music
                make_instrumental:
                  type: boolean
                  description: Whether to make the music instrumental
                  default: false
                vocal_only:
                  type: boolean
                  description: Whether to generate only vocals of output audio
                  default: false
                title:
                  type: string
                  description: Title of the generated music track
                  example: My Generated Track
                gender:
                  type: string
                  description: Gender of the voice model
                  example: female
                voice_id:
                  type: string
                  description: Voice model to convert generated audio
                  example: e1cb7380-e3db-433a-b186-a996d7545986
                generate_album_cover:
                  type: boolean
                  description: Whether to generate an album cover for the generated audio
                  default: false
                lyrics_timestamps:
                  type: boolean
                  description: Whether to generate timestamps for the lyrics
                  default: false
                model:
                  type: string
                  description: Model version to use for generation
                  example: v7
                  enum:
                    - v6
                    - v6-pro
                    - v7
                    - v7-pro
                webhook_url:
                  type: string
                  description: URL for callback upon completion
                  example: https://example.com/my-webhook
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  message:
                    type: string
                  task_id:
                    type: string
                  conversion_id_1:
                    type: string
                  conversion_id_2:
                    type: string
                  eta:
                    type: integer
                  is_flagged:
                    type: boolean
                  reason:
                    type: string
                  credit_estimate:
                    type: number
              example:
                success: true
                message: Message published to queue
                task_id: 50c04348-7077-5ffd-a407-55f031db20ef
                eta: 154
                conversion_id_1: 5a2c6385-e2e1-5531-a530-aab3ff040a3c
                conversion_id_2: e3c65d75-d1fd-549c-9e63-4b303a01cd23
                is_flagged: false
                reason: ''
                credit_estimate: 0.06
        '402':
          description: Payment Required
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  error:
                    type: string
              example:
                success: false
                message: Insufficient credit balance
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  error:
                    type: string
              example:
                success: false
                message: Internal Server Error
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization

````