上传并翻唱音乐
POST
/api/v1/generate/upload-cover
覆盖音乐样式
参数使用指南
字符限制
当 customMode 为 true（自定义模式）时：
instrumental 为 true：需要提供 style、title 和 uploadUrlinstrumental 为 false：需要提供 style、prompt、title 和 uploadUrluploadUrl 用于指定音频文件的上传位置。请确保上传的音频长度不超过 8 分钟。当 customMode 为 false（非自定义模式）时：
instrumental 设置如何，只需要提供 prompt 和 uploadUrlprompt 长度限制：500 字符开发者注意事项
1.
customMode 设为 false，instrumental 设为 false，只提供 prompt 和 uploadUrl。这是最简单的配置，可以快速测试 API 并体验结果。2.
3.
customMode 和 instrumental 设置确保提供所有必要参数，避免出错。4.
prompt、style 和 title 的字符长度限制，确保成功处理。5.
text（文本生成完成）、first（第一首完成）、complete（全部完成）。6.
7.
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。仅在开启自定义模式（customMode 为 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-cover' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"uploadUrl": "https://api.example.com/upload",
"prompt": "一段平静舒缓的钢琴曲，带有柔和的旋律",
"style": "古典",
"title": "宁静钢琴冥想",
"customMode": true,
"instrumental": true,
"model": "V4",
"negativeTags": "重金属, 强节奏鼓点",
"callBackUrl": "https://api.example.com/callback",
"vocalGender": "m",
"styleWeight": 0.65,
"weirdnessConstraint": 0.65,
"audioWeight": 0.65,
"personaId": "persona_123"
}'Response Response Example
200 - Example 1
{
"code": 200,
"msg": "success",
"data": {
"taskId": "5c79****be8e"
}
}