Music GenerationActive
ElevenLabs Music v2.5 Inpainting
Edit an existing song by regenerating selected time ranges with ElevenLabs Music v2.5. Use chunk plans to swap lyrics, style, or arrangement.
Text to Music
Model ID
text to music v2.5 inpainting
Provider
elevenlabs
Updated
Nov 4, 2026, 13:10
wiro playground—elevenlabs/text to music v2.5 inpainting
Updated Nov 4, 2026, 13:10
Overview
Text to Music v2.5 Inpainting by ElevenLabs edits an existing track without rebuilding the whole song. You upload a song, then provide a structured edit plan that mixes unchanged slices with newly generated sections. The model generates new audio that matches the surrounding context, so your edits land in time and feel coherent. You get a single edited track back as an MP3, ready to review and iterate.
What you can build
- Replace just a chorus with new lyrics while keeping the verse unchanged
- Fix a single awkward line by regenerating a short time span
- Change the style of a bridge (instrumentation, energy, vocal approach) without touching the rest
- Extend a song by adding a new intro or outro around kept audio
- Create a seamless loop by keeping a repeated slice and generating a short transition
- Generate a “similar” continuation by conditioning new sections on a short reference moment
Inputs
- An existing song file to edit, uploaded as an MP3. If the file is longer than 10 minutes, only the first 10 minutes are used.
- A JSON “composition plan” that describes the full edited timeline as an ordered list of chunks.
- For chunks you want to keep unchanged, you specify a start and end time range in milliseconds from the beginning of the uploaded song.
- For chunks you want to regenerate, you provide section text that can include a label (like Verse or Chorus), lyrics lines, and short inline directions (like “guitar solo”).
- For regenerated chunks, you set the target duration in milliseconds. Each new chunk must be between 3 seconds and 120 seconds.
- For regenerated chunks, you provide style tags to include and style tags to avoid. Style tags must be written in English.
- For regenerated chunks, you choose how strongly the new audio should follow the surrounding context (low, medium, or high).
- Optional: for a regenerated chunk, you can point to a short reference slice of the uploaded song (up to 30 seconds) and set how strongly the new audio should match its feel.
- An MP3 output quality preset that sets the track’s sample rate and bitrate.
Outputs
- One edited audio track as an MP3 file.
- The MP3 uses the sample rate and bitrate you selected, and it contains both kept segments and regenerated segments in a single continuous timeline.
Recommended settings
- Keep regenerated chunks musically meaningful. 10–30 seconds per regenerated section is a good starting range for chorus or verse edits.
- Put the most important style guidance early. The first regenerated section has outsized influence on the overall sound.
- Use at least 6–7 style tags in the first regenerated section when you need a specific genre and production direction.
- Use “high” context adherence when you want the edit to blend tightly into the neighboring audio.
- Use negative style tags aggressively to block common failure modes like unwanted vocals, distortion, or genre drift.
Limitations
- The edited timeline can contain up to 30 chunks.
- Total edited duration can be up to 10 minutes.
- Each regenerated chunk must be 3–120 seconds long.
- Any reference slice used to guide a regenerated chunk is limited to 30 seconds.
- Very small kept ranges can be fragile. The underlying inpainting workflow expects real musical context, not single-sample edits.
- The section text used for a regenerated chunk has practical formatting limits. Long, unstructured lyrics blocks may be rejected or produce unstable results.
- Low-quality inputs can reduce edit quality. Heavy MP3 compression, clipping, or noisy mixes can cause audible seams or artifacts around edit boundaries.
- Some inpainting workflows require your track to be stored for editing under your ElevenLabs account. Access may depend on your plan and enabled features.
Safety & compliance
- Uploaded audio is inspected for copyright compliance before it can be used for editing.
- Prompts and section text that include copyrighted lyrics, or that reference specific artists or songs, may be blocked and returned as an error.
- Only upload and edit audio you have the rights to use.
- Audio reference and inpainting guide the sound and structure. They don’t copy or remix the original into a derivative “remaster” by design.
Example prompts
Great starting points for text to music v2.5 inpainting.
{"chunks":[{"range":{"start_ms":0,"end_ms":10000}},{"text":"[Chorus]\nHold me close, the tide is turning\nGolden skies are softly burning","duration_ms":10000,"positive_styles":["gentle bossa chorus","soft flute","breathy female vocals"],"context_adherence":"high"}]}Music Generation
{"chunks":[{"text":"[Verse]\nHeadlights cutting through the rain\nWe were never meant to stay the same","duration_ms":10000,"positive_styles":["alternative rock","crunchy electric guitars","driving drums","moody male vocals","120 bpm","great production quality"],"negative_styles":["synths"],"context_adherence":"high"},{"range":{"start_ms":10000,"end_ms":20000}}]}Music Generation
{"chunks":[{"range":{"start_ms":0,"end_ms":10000}},{"text":"[Chorus]\nLift me up, carry me higher\nSet my weary heart on fire","duration_ms":10000,"positive_styles":["uplifting gospel","hammond organ","full gospel choir","hand claps"],"negative_styles":["slow ballad"],"context_adherence":"low"}]}Music Generation
{"chunks":[{"range":{"start_ms":0,"end_ms":10000}},{"text":"[Chorus]\nJump up high, touch the sky\nDance until the morning light","duration_ms":10000,"positive_styles":["catchy afrobeat hook","call and response vocals","bright horns"],"conditioning_ref":{"range":{"start_ms":10000,"end_ms":20000}},"condition_strength":"medium"}]}Music Generation
API quick start
Run text to music v2.5 inpainting with a single API call.
POST https://api.wiro.ai/v1/Run/elevenlabs/text-to-music-v2-5-inpainting
{
"prompt": "{\"chunks\":[{\"range\":{\"start_ms\":0,\"end_ms…",
"inputAudio": "https://your-cdn.com/input.mp3",
"outputFormat": "mp3_44100_128"
}curl
curl -X POST "https://api.wiro.ai/v1/Run/elevenlabs/text-to-music-v2-5-inpainting" \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_WIRO_API_KEY" \
--data-binary @- <<'JSON'
{
"prompt": "{\"chunks\":[{\"range\":{\"start_ms\":0,\"end_ms…",
"inputAudio": "https://your-cdn.com/input.mp3",
"outputFormat": "mp3_44100_128"
}
JSONOther models you might like
Explore similar music generation models.



