Provide the instrumental recording
Choose the source arrangement and prepare an accessible upload_url. Retain the original audio so the new vocal version can be reviewed in the intended musical context.
Add Vocals music layering API
Provide an instrumental recording and the lyrics or vocal direction you want to develop. Add Vocals uses upload_url, prompt, title, style, negative_tags and mv with accepted optional preferences. Retrieve the completed music, listen to the vocal phrasing with the source arrangement and review it against the intended words and musical character before choosing a version.
Vidgo provides access to Add Vocals through PoYo’s music-tool integration. Model and tool names and trademarks belong to their respective owners.Explore the Add Vocals Task
Prepare the instrumental recording, song text or vocal brief and the musical style. Open the task, complete the required fields and review the returned version with the source and intended vocal direction.
Add Vocals Instrumental Audio, Lyrics and Vocal Style Inputs
Provide an accessible instrumental recording through upload_url and select mv: V4_5PLUS or V5, as offered by the current form. prompt describes the lyrics or vocal direction, title names the result, style describes the musical and singing direction, and required negative_tags describes elements to reduce. The accepted optional controls include vocal_gender and the documented style_weight, weirdness_constraint and audio_weight values from 0 to 1, with up to two decimal places.
| Model / task | Input and workflow |
|---|---|
| Add Vocals | Layer AI-generated vocals onto existing instrumental tracks. Provide lyrics or descriptions and the API generates matching vocal performances with customizable gender, style, and expression. Transform instrumental music into complete songs with professional AI singing. |
Add Vocals: Vocal Addition to Instrumentals and Singing Direction Controls
Use the input required by this operation and inspect the returned result together with its source. The guidance below explains how to prepare the request, review the output and retain the information needed for the next creative or development step.
{
"model": "add-vocals",
"input": {
"upload_url": "https://cdn.doculator.org/audio/FY414XS6JCUXLDGW/FY414XS6JCUXLDGW_1.mp3",
"prompt": "[Verse]\nRain has left the window bright\nMorning folds away the night\nOn the table, bread and tea\nThere is room for you and me\n[Chorus]\nOpen up the day again\nLet the sunlight wander in\nEvery road can start from here\nOne small step and skies are clear",
"title": "Harbor Morning Song",
"style": "Warm acoustic folk, clear intimate lead vocal, gentle hopeful phrasing",
"negative_tags": "harsh distortion, shouted vocals",
"mv": "V5"
}
}Prepare the lyrics or vocal direction
Write the intended song words or a complete vocal brief in prompt. Review the completed phrasing and lyric treatment against those instructions.
Describe the musical delivery
Use style to express the genre and delivery direction, and set a title for the result. Include required negative_tags to describe the elements you want to reduce.
{
"model": "add-vocals",
"input": {
"upload_url": "https://cdn.doculator.org/audio/FY414XS6JCUXLDGW/FY414XS6JCUXLDGW_2.mp3",
"prompt": "[Verse]\nLanterns trace the evening tide\nSmall boats turn toward the light\n[Chorus]\nCarry home the quiet sea\nLeave a little room for me",
"title": "Lanterns on the Tide",
"style": "Reflective acoustic folk, soft lead vocal, quiet coastal evening mood",
"negative_tags": "harsh distortion, shouted vocals",
"mv": "V5"
}
}Use the accepted preference fields
Prepare an applicable vocal_gender preference and supported musical weights when useful. Keep those settings with the full prompt and source when reviewing the result.
Review the completed vocal music
Read the returned candidates and listen with the source instrumental. Save the selected audio URL and identifiers for another edit, continuation or project presentation.
Add Vocals Original Vocal Addition to Instrumental Examples
The two instrumental candidates from Harbor Paper Lanterns were submitted with V5 and two original lyric briefs. Each request retains the source URL, style, title and negative_tags. Listen to the source arrangement and every completed vocal candidate, checking how the supplied lyrics and vocal phrasing fit the music.
Musical direction
[Verse] Rain has left the window bright Morning folds away the night On the table, bread and tea There is room for you and me [Chorus] Open up the day again Let the sunlight wander in Every road can start from here One small step and skies are clear
Musical direction
[Verse] Lanterns trace the evening tide Small boats turn toward the light [Chorus] Carry home the quiet sea Leave a little room for me
Music Workflow Uses for Add Vocals
Choose the instrumental recording that should guide the song and prepare a directly downloadable upload_url. Write the lyrics or vocal brief and the intended style before submitting, then retain the original arrangement for comparison with the result.
A song from an instrumental idea
Prepare the instrumental source, song text and style direction. Review the returned vocal version against the arrangement and intended meaning before choosing the song draft.
Testing lyric delivery
Use the selected instrumental and a complete lyric prompt. Listen to the returned phrasing with the music before refining the words or supported preferences.
Exploring a vocal style direction
Prepare the instrumental and describe the intended genre and delivery. Review the generated treatment with the original arrangement before selecting another iteration.
A complete songwriting draft
Combine the source arrangement, lyrics, title and style in the request. Use the reviewed result when discussing the song’s structure and musical character.
A source-and-result review
Retain the original instrumental, vocal brief and returned candidate together. Review them when checking how the intended words fit the musical project.
Refining a vocal version
Listen to the first result and revise the prompt, style or supported preference around observed details. Compare the next version with the same instrumental source.
Add Vocals Input Requirements and API Pricing
The price table reads the current catalog rate for a new processing request in this task. Preparing source music or submitting another music operation uses that operation’s own price. Review the current rate before submitting, retain the returned processing task ID and use the completed result when planning the next step.
| Tool | Provider | Operation | Input | Result type | Current rate |
|---|---|---|---|---|---|
| Add Vocals | PoYo | Vocal addition | Instrumental upload_url, prompt, title, style and negative_tags; mv: V4_5PLUS / V5 | Music version with generated vocals | $0.1 / request |
How to Use Add Vocals on Vidgo
Prepare the source input, then review the completed result and its next use.
Test online
Test the prepared request online
Open the task and prepare the instrumental URL or upload the source. Fill the vocal prompt, title, style and negative_tags, review applicable preferences and the current request rate, then submit. Listen to the returned vocal version with the original instrumental.
Why Use Add Vocals on Vidgo
Use the existing task, current request rate and API documentation to connect source preparation, result review and the next music workflow.
Source preparation and result review
Prepare the input required by the operation
Choose the instrumental recording that should guide the song and prepare a directly downloadable upload_url. Write the lyrics or vocal brief and the intended style before submitting, then retain the original arrangement for comparison with the result.
Inspect the completed output
Listen to the vocal phrasing, lyric delivery and musical treatment with the original instrumental. Review the requested style and any vocal preference, then inspect the returned duration and complete result. Retain the actual prompt, style, source URL and selected candidate when refining the next version.
Review the current request rate
The price table reads the current catalog rate for a new processing request in this task. Preparing source music or submitting another music operation uses that operation’s own price. Review the current rate before submitting, retain the returned processing task ID and use the completed result when planning the next step.
API integration and follow-up work
Use the accepted request fields
Submit model: add-vocals with input.upload_url, prompt, title, style and negative_tags. Include accepted optional preferences when applicable. Save the returned processing task_id and query music details for the completed audio result and candidate identifiers.
Track the processing task
Authenticate with your Vidgo API credentials and submit the exact model identifier with the required input fields. Retain the returned processing task_id so your application can track the operation and retrieve its result. Use the task documentation when configuring any completion notification.
Retain the result and source association
Query /api/generate/detail/music?task_id=YOUR_PROCESSING_TASK_ID with the returned processing ID, or handle the configured notification. When the task finishes, inspect the operation-specific result in files and retain its source association. Listen to the vocal phrasing, lyric delivery and musical treatment with the original instrumental. Review the requested style and any vocal preference, then inspect the returned duration and complete result. Retain the actual prompt, style, source URL and selected candidate when refining the next version.
Add Vocals API FAQ
Provide an instrumental recording and the lyrics or vocal direction you want to develop. Add Vocals uses upload_url, prompt, title, style, negative_tags and mv with accepted optional preferences. Retrieve the completed music, listen to the vocal phrasing with the source arrangement and review it against the intended words and musical character before choosing a version.
Explore More Model Families
Recommended Reading
Read music-tool introductions, API guides and platform comparisons to understand required sources, returned results, request costs and follow-up workflows.
