API Documentation & Integration

Overview

Suno2MV provides a developer-friendly RESTful API for music platforms, indie developers, and media creators who wish to automate audio-to-editable-music-video pipelines.

All requests use HTTPS and standard JSON payloads.

Authentication

Pass your secret API key via standard Bearer token authorization:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Generate and manage keys in your API Keys Dashboard.

---

Key Endpoints

1. Audio Ingestion & Beat Analysis

POST /api/v1/audio/analyze

Extracts song duration, BPM tempo, downbeat transients, and energy density profile.

Request Payload:

{
  "audio_url": "https://example.com/audio/sample.mp3"
}

Response:

{
  "duration": 182.4,
  "bpm": 128,
  "beats_count": 389,
  "energy_profile": "high-energy"
}

---

2. Whisper Word-Level Lyrics Alignment

POST /api/v1/lyrics/align

Aligns lyric phrases to audio millisecond timestamps for synchronized subtitles.

---

3. Storyboard Generation

POST /api/v1/storyboard/generate

Invokes Claude Opus 5.5 to structure 4–8 shots based on the audio pace and visual genre.

---

4. Video Rendering & Export

POST /api/v1/render/export

Enqueues asynchronous render jobs. Choose between code-kinetic, hybrid, or ai-diffusion.

Request Payload:

{
  "project_id": "proj_12345",
  "mode": "hybrid",
  "resolution": "1080p",
  "fps": 60,
  "clip_range": "chorus-30s"
}

---

Support & Enterprise Limits

Standard accounts include 60 requests/min. For high-volume dedicated GPU rendering pipelines, contact: support@suno2mv.com.