Music API FAQ & Troubleshooting

0# Frequently Asked Questions

Common questions about using MusicAPI.

Getting Started

How do I get started with MusicAPI?

Subscribe to a plan (new accounts get 30 free test credits)

Get your API key from the dashboard

Make your first API call

What's included in the free trial?

New accounts receive 30 free test credits to explore the platform's features before subscribing.

Music Generation

How do I create a song with my own lyrics?

Enable custom_mode and provide your lyrics in the prompt field:

{
  "custom_mode": true,
  "mv": "sonic-v4-5",
  "title": "My Song",
  "tags": "pop, rock",
  "prompt": "[Verse]\nYour lyrics here\n\n[Chorus]\nChorus lyrics here"
}

How do I let AI generate lyrics for me?

Set custom_mode to false and use gpt_description_prompt:

{
  "custom_mode": false,
  "mv": "sonic-v4-5",
  "gpt_description_prompt": "An upbeat song about summer adventures"
}

How do I create instrumental music without vocals?

Set make_instrumental to true:

{
  "custom_mode": false,
  "mv": "sonic-v4-5",
  "make_instrumental": true,
  "gpt_description_prompt": "A peaceful piano melody"
}

How do I control the singer's gender?

Use the vocal_gender parameter (only available for v4-5 and above):

{
  "custom_mode": true,
  "mv": "sonic-v4-5",
  "vocal_gender": "f",
  "prompt": "...",
  "tags": "pop"
}

Value	Description
`f`	Female vocal
`m`	Male vocal

Can I control the exact duration of a song?

Short answer: Sonic and Producer do not support precise duration control. Nuro supports it - see the nuro-instruction for details.

For Sonic and Producer, you can use indirect methods to influence song length:

Model Version Limits

Different model versions have different maximum durations per generation:

Model Version	Max Duration
sonic-v3-5	~2 minutes
sonic-v4	~2 minutes
sonic-v4-5	~4 minutes
sonic-v4-5-plus	~4 minutes
sonic-v5	~4-8 minutes

Tips to Make Songs Shorter

Use ending tags - Add [Outro], [End], [Fade Out], or [Short Instrumental Outro] in your lyrics to signal the song should end:

[Verse]
Your verse lyrics...

[Chorus]
Your chorus lyrics...

[Outro]
Final words...
[End]

Write shorter lyrics - Less lyrics generally means shorter songs

Use concise structure - Fewer sections (e.g., just Verse → Chorus → Outro)

Tips to Make Songs Longer

Use the Extend feature - Generate a song, then use extend_music to add more content:

{
  "task_type": "extend_music",
  "continue_clip_id": "your-clip-id",
  "continue_at": 180,
  "custom_mode": true,
  "mv": "sonic-v4-5",
  "prompt": "[Bridge]\nNew section...\n\n[Final Chorus]\n..."
}

Write more lyrics - More content generally produces longer songs

Add more sections - Include multiple verses, pre-chorus, bridge, etc.

Use instrumental breaks - Add [Instrumental] or [Guitar Solo] tags

For Precise Duration Control

Use the Nuro model which supports the duration parameter for exact control over instrumental music length.

Extending & Covering Songs

How do I extend an existing song?

Use extend_music task type with the original clip_id and specify where to continue:

{
  "task_type": "extend_music",
  "continue_clip_id": "original-clip-id",
  "continue_at": 120,
  "custom_mode": true,
  "mv": "sonic-v4-5",
  "prompt": "[Bridge]\nNew lyrics for extension...",
  "tags": "pop"
}

How do I get the full extended song (original + extension)?

After extending, use concat_music to merge the original and extended parts:

{
  "task_type": "concat_music",
  "continue_clip_id": "extended-clip-id"
}

This produces a single full-length track combining both parts.

How do I create a cover version?

Use cover_music task type:

{
  "task_type": "cover_music",
  "continue_clip_id": "original-clip-id",
  "custom_mode": true,
  "mv": "sonic-v4-5",
  "prompt": "...",
  "tags": "jazz, smooth",
  "audio_weight": 0.6
}

The audio_weight parameter (0-1) controls how much the original influences the cover.

Uploading Your Own Music

How do I upload my own audio file?

Use the upload endpoint to get a clip_id:

Requirements:

Audio duration: max 8 min.

Must be copyright-free or owned by you

Processing takes approximately 20 seconds

How do I extend/cover my uploaded music?

Use the special task types for uploaded music:

Operation	Task Type
Extend uploaded music	`extend_upload_music`
Cover uploaded music	`cover_upload_music`

Important: Do not use extend_music or cover_music for uploaded files. Use the _upload_ variants instead.

Personas (Virtual Singers)

What is a persona?

A persona is a virtual singer profile created from an existing song. Once created, you can generate new songs using that voice.

How do I create a persona?

POST /api/v1/sonic/persona

{
  "name": "My Singer",
  "clip_id": "source-clip-id",
  "describe": "Smooth jazz vocal with warm tone",
  "styles": "jazz, smooth, warm"
}

How do I use a persona to generate music?

Use persona_music task type with the persona_id:

{
  "task_type": "persona_music",
  "persona_id": "your-persona-id",
  "custom_mode": true,
  "mv": "sonic-v4-5",
  "prompt": "...",
  "tags": "pop"
}

Lyrics Generation

How do I generate lyrics?

Use the lyrics endpoint:

POST /api/v1/sonic/lyrics

{
  "prompt": "A love song about long distance relationships"
}

Cost: 2 credits per generation

Technical Questions

What audio formats are supported?

Input: MP3, WAV, and most common audio formats via URL

Output: MP3 (audio_url), MP4 (video_url), WAV (via get-wav endpoint)

How long does generation take?

Operation	Typical Time
Create music	2min
Extend music	1.5min
Cover music	1.5min
Concat music	1min
Upload music	~20 seconds

What's the recommended polling interval?

Poll every 15-25 seconds for task results.

Why did my request fail?

Common reasons:

Error	Cause	Solution
401 Unauthorized	Invalid API key	Check your API key
403 Forbidden	Insufficient credits	Purchase more credits
400 Validation Error	Invalid parameters	Check parameter values
429 Rate Limit	Too many requests	Wait 3 seconds between requests

Billing & Credits

How many credits does each operation cost?

See the Credits Usage Guide for complete pricing.

Quick reference:

Operation	Credits
Create/Extend/Cover	15
Concat	2
Upload	2
Persona/BPM/VOX	1

Do unused credits roll over?

Subscription credits: No, reset monthly

Extra credits: Yes, never expire

Which credits are used first?

Extra credits are consumed before subscription credits.

Output & Usage Rights

Are there watermarks on generated music?

No, all generated audio is watermark-free.

Can I use generated music commercially?

Yes, generated music can be used for commercial purposes. Check our terms of service for specific licensing details.

How many songs does each generation produce?

Most operations produce 2 songs per request (15 credits), giving you options to choose from.

Still Have Questions?

Documentation: docs.musicapi.ai

Telegram: Join our channel for updates, examples, and support

Email: Contact us for enterprise inquiries:support@musicapi.ai

Getting Started#

How do I get started with MusicAPI?#

What's included in the free trial?#

Music Generation#

How do I create a song with my own lyrics?#

How do I let AI generate lyrics for me?#

How do I create instrumental music without vocals?#

How do I control the singer's gender?#

Can I control the exact duration of a song?#

Model Version Limits#

Tips to Make Songs Shorter#

Tips to Make Songs Longer#

For Precise Duration Control#

Extending & Covering Songs#

How do I extend an existing song?#

How do I get the full extended song (original + extension)?#

How do I create a cover version?#

Uploading Your Own Music#

How do I upload my own audio file?#

How do I extend/cover my uploaded music?#

Personas (Virtual Singers)#

What is a persona?#

How do I create a persona?#

How do I use a persona to generate music?#

Lyrics Generation#

How do I generate lyrics?#

Technical Questions#

What audio formats are supported?#

How long does generation take?#

What's the recommended polling interval?#

Why did my request fail?#

Billing & Credits#

How many credits does each operation cost?#

Do unused credits roll over?#

Which credits are used first?#

Output & Usage Rights#

Are there watermarks on generated music?#

Can I use generated music commercially?#

How many songs does each generation produce?#

Still Have Questions?#