Music Visualizer

API Reference

Use the Music Visualizer API to render videos programmatically from your applications or AI agents.

Authentication

Include your API key in the Authorization header:

Authorization: Bearer mvk_your_api_key

Endpoints

POST
/api/v1/render

Create a new render job. Send audio_file (multipart), optional background_file, and settings JSON.

GET
/api/v1/render/:id

Get render job status and download URL when ready.

GET
/api/v1/render/:id/download

Download the rendered MP4 file (expires 30 min after render).

GET
/api/v1/credits

Get current credit balance.

GET
/api/v1/usage

Get recent transactions and render history.

GET
/api/v1/library

Browse visualizer styles, particles, and backgrounds. Filter with ?type=SPECTRUM

POST
/api/v1/favorites

Add a library item to favorites (1 credit).

POST
/api/v1/themes

Save current editor settings as a theme (5 credits).

POST
/api/v1/lyrics/parse

Parse LRC or plain text lyrics into timestamped lines.

POST
/api/v1/lyrics/generate

Transcribe audio to lyrics using Whisper (1,000 credits).

POST
/api/v1/recover

Request API key recovery via email.

Render settings example

{
  "format": "portrait",
  "quality": "1080p",
  "duration": {
    "start": 0,
    "end": 30
  },
  "visualizer": {
    "type": "rounded-bars",
    "accentColor": "#ffffff",
    "barCount": 96,
    "intensity": 1.2
  },
  "background": {
    "type": "preset",
    "preset": "noir"
  },
  "lyrics": {
    "enabled": true,
    "direction": "auto",
    "style": {
      "mode": "caption",
      "position": "bottom"
    },
    "lines": [
      {
        "start": 12,
        "end": 16,
        "text": "First line"
      }
    ]
  },
  "watermark": {
    "enabled": true,
    "position": "bottom-right"
  }
}

Credit pricing

ResolutionCredits / minExample (1 min)
720p1010 credits
1080p2020 credits
1440p4040 credits
4K8080 credits

Duration billed in 15-second intervals. +10 credits to remove watermark.

Get your API key →Buy credits