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 (available for 30 days after the render completes).

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

Sync provided lyrics to audio timing using GaudioLab (300 credits per track).

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"
  }
}

format accepts 16:9 / landscape, 9:16 / portrait, or 1:1 / square. The output resolution is derived from quality (720 / 1080 / 1440 / 2160) and the format — e.g. portrait 1080p renders 1080×1920, square 1080p renders 1080×1080. If you pass explicit renderParams.width/height, the shorter side must match the requested quality. Portrait 4K is not supported.

Credit pricing

Resolution	Credits / render
720p	50
1080p	50
2K / 1440p	50
4K / 2160p	50

Flat 50 credits per render (max 10 minutes). +10 credits to remove watermark.

Get your API key →Buy credits