Add or replace vocals in an existing instrumental or music clip
Endpoint
POST /api/v1/music/add-vocals
Asynchronous. Returns a task_id. Poll Get Task for results.Takes an existing clip and “paints” new vocal content over a specified time range using a sample source clip as the vocal reference.
Request body
Field
Type
Required
Description
chop_sample_clip_id
string
Yes
Clip ID of the vocal sample source.
chop_sample_start_s
float
No
Start time (seconds) in the sample clip. Default 0.
chop_sample_end_s
float
No
End time (seconds) in the sample clip. Default: full clip.
prompt
string
No
Lyric content for the new vocal section. Supports Chinese and English.
tags
string
No
Style tags (e.g. "流行 女声" or "pop female").
mv
string
No
Model version override.
callback_url
string
No
Webhook URL for completion notification. See Webhooks.