上传并扩展音乐
POST
/api/v1/generate/upload-extend
上传并扩展音乐
参数使用指南
字符限制
当 defaultParamFlag 为 true（自定义参数模式）时：
instrumental 为 true：需要提供 style、title 和 uploadUrlinstrumental 为 false：需要提供 style、prompt、title 和 uploadUrlcontinueAt：音频开始扩展的时间点（秒）。该参数需大于 0 且小于上传音频的总时长。uploadUrl：用于指定音频文件的上传位置。请确保上传的音频长度不超过 8 分钟。当 defaultParamFlag 为 false（使用默认参数模式）时：
instrumental 设置如何，仅需提供 uploadUrl 和 prompt开发者注意事项
1.
2.
3.
4.
uploadUrl 参数用于指定音频文件的上传位置；请提供有效的 URL。可选参数
| 参数名 | 类 型 | 说明 |
|---|---|---|
vocalGender | string | 人声性别偏好。m 代表男声，f 代表女声。 |
styleWeight | number | 对风格的遵循强度。范围 0–1，保留两位小数。示例：0.65。 |
weirdnessConstraint | number | 创意/离散程度控制。范围 0–1，保留两位小数。示例：0.65。 |
audioWeight | number | 音频要素权重。范围 0–1，保留两位小数。示例：0.65。 |
personaId | string | 应用到生成音乐的 personaId。仅在开启自定义参数模式（defaultParamFlag 为 true）时可用。生成 personaId 请访问 生成 Persona。 |
Callbacks
Request
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.kie.ai/api/v1/generate/upload-extend' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"uploadUrl": "https://storage.example.com/upload",
"defaultParamFlag": true,
"instrumental": true,
"continueAt": 60,
"model": "V4",
"callBackUrl": "https://api.example.com/callback",
"prompt": "Extend the music with more relaxing notes",
"style": "Classical",
"title": "Peaceful Piano Extended",
"negativeTags": "Relaxing Piano",
"vocalGender": "m",
"styleWeight": 0.65,
"weirdnessConstraint": 0.65,
"audioWeight": 0.65,
"personaId": "persona_123",
"personaModel": "style_persona"
}'Response Response Example
{
"code": 200,
"msg": "success",
"data": {
"taskId": "5c79****be8e"
}
}