Music AI V2
Create music powered by AI using just a prompt, lyrics, or a defined music style.
Choose your model
v6
v6-pro
v7
v7-pro
Model comparison
| Model | Audio quality | Streaming | Best for |
|---|---|---|---|
v6 | Very good | - | Fast, dependable everyday tracks |
v6-pro | Very good | Real-time | Live, as-it-generates playback |
v7 | Best-in-class | - | Highest-quality final renders |
v7-pro | Best-in-class | Real-time | Production apps that want everything |
model parameter (v6, v6-pro, v7, or v7-pro). Streaming is available on the pro models for paid users. Per-model rates are listed on the Pricing page.
Key features
- Compose custom songs using your own lyrics and chosen music style
- Generate complete tracks from a single prompt, including lyrics, instrumentation, and melody
- Apply voice conversion using a custom voice model
- Output full tracks, instrumental-only, or vocal-only versions
- View the live streaming of the song as it generates (
promodels) - Asynchronous webhook support for clean integration
Endpoint
Sample Output
Listen to a real sample output: Prompt: a song about greenery, nature and forest. Download AudioTry It Yourself
Use the MusicAI Endpoint Explorer to test your own requests using prompts, lyrics, and more.Each request returns two distinct versions of the track.
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
prompt | String | Optional | - | A natural language prompt for music generation |
title | String | Optional | - | Title of the generated music |
music_style | String | Optional | - | Musical style or genre (e.g., Rock, Pop, Lo-fi) |
lyrics | String | Optional | "" | Custom lyrics to use in the song |
make_instrumental | Boolean | Optional | false | If true, generate instrumental-only audio |
vocal_only | Boolean | Optional | false | If true, generate vocals without instruments |
voice_id | String | Optional | "" | Apply voice model for vocal rendering |
generate_album_cover | Boolean | Optional | false | If true, generate an album cover for the generated audio |
model | String | Optional | ”v6” | Allowed values: v6, v6-pro, v7, v7-pro |
webhook_url | String | Optional | "" | URL to receive generated results via webhook |
gender | String | Optional | "" | Allowed values: male, female, neutral. |
content-type: application/json
Generation Modes
Custom Mode
Provide bothlyrics and music_style to craft a fully personalized song.
Prompt Mode
Supply only aprompt and let the system generate everything: lyrics, style, vocals, and more.
make_instrumental,vocal_only, and Music AI generation with customvoice_idare supported in both modes.
Webhook Delivery
Once the generation is complete, webhooks will be triggered to deliver the following:Standard Requests (non-instrumental):
- 2 (webhooks) x Music conversion details (one per version)
- 2 (webhooks) x Lyrics with timestamp data
- 2 (webhook ) x Streaming URL
- 1 (webhook ) x Album cover image
Instrumental-only Requests:
- 2 (webhook) x Music conversion details (one per version)
- 2 (webhook ) x Streaming URL
- 1 (webhook) x Album cover image
Webhook responses include detailed metadata including task_id, conversion_id, audio files (conversion_path), lyrics etc.
Sample Request (Python)
Sample Response
Webhook Sample Payload
Note: Each conversion_id corresponds to a different variation of the track.
Payload and Request Formation
Authorizations
Body
A natural language prompt for music generation. Keep it under 280 characters for guaranteed results, but detailed—the clearer and more descriptive it is, the better the outcome.
Style of music to generate (e.g., Rock, Pop)
Custom lyrics for the generated music
Whether to make the music instrumental
Whether to generate only vocals of output audio
Title of the generated music track
Gender of the voice model
Voice model to convert generated audio
Whether to generate an album cover for the generated audio
Model version to use for generation
v6, v6-pro, v7, v7-pro URL for callback upon completion