KIE.AI
Old Model
  • All Model
  • Old Model
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
Support
Old Model
  • All Model
  • Old Model
Old Model
  • All Model
  • Old Model
Suno API
4o Image APIVeo3.1 APIRunway APIFlux Kontext API
Suno API
4o Image APIVeo3.1 APIRunway APIFlux Kontext API
  1. Music Generation
  • Suno API 快速开始
  • Music Generation
    • 音乐封面生成回调
    • 生成音乐回调
    • 音乐扩展回调
    • 音频上传和翻唱回调
    • 音频上传和扩展回调
    • 添加伴奏回调
    • 添加人声回调
    • 替换音乐分区回调
    • 生成音乐
      POST
    • 延长音乐
      POST
    • 上传并翻唱音乐
      POST
    • 上传并扩展音乐
      POST
    • 添加伴奏生成音乐
      POST
    • 添加人声生成音乐
      POST
    • 获取音乐任务详情
      GET
    • 获取带时间戳的歌词
      POST
    • 提升音乐风格
      POST
    • 替换音乐分区
      POST
    • 生成音乐封面
      POST
    • 获取音乐封面生成详情
      GET
    • 生成 Persona
      POST
    • 生成混音音乐
      POST
    • 恢复音频
      POST
  • Lyrics Generation
    • 生成歌词回调
    • 生成歌词
      POST
    • 获取歌词任务详情
      GET
  • WAV Conversion
    • 转换为WAV格式回调
    • 转换为WAV格式
    • 获取WAV转换详情
  • Vocal Removal
    • 音频分离回调
    • MIDI 生成回调
    • 人声和乐器分离
    • 获取人声和乐器分离详情
    • 从音频生成 MIDI
    • 获取 MIDI 生成详情
  • Music Video Generation
    • MP4生成完成回调
    • 创建音乐视频
    • 获取音乐视频详情
  • Sounds Generation
    • 生成声音
  • voice
    • Suno Voice 生成回调
    • Suno Voice 验证短句回调
    • Suno Voice生成验证短句接口
    • Suno Voice获取验证短句接口
    • Suno Voice自建音色生成接口
    • Suno Voice获取自建音色记录
    • Suno Voice 重新生成验证短句
    • Suno Voice检查是否可用接口
  1. Music Generation

替换音乐分区

POST
/api/v1/generate/replace-section
替换现有音乐的指定时间段。

使用指南#

此接口可以替换已生成音乐中的特定时间段
需要提供原始音乐的任务 ID 和要替换的时间范围
替换后的音频会与原音乐自然融合
本接口固定为自定义模式

参数详情#

始终必填:prompt、tags、title、infillStartS、infillEndS、fullLyrics
lyrics 为替换片段的歌词,可选,V6 最多 5000 字符
可选:negativeTags、vocalGender、styleWeight、weirdnessConstraint、audioWeight、variety、personaId、personaModel、callBackUrl

时间范围说明#

infillStartS 必须小于 infillEndS
时间值精确到小数点后 2 位,例如:10.50 秒
替换时间范围至少为 10 秒
替换时长建议不超过原音乐总时长的 50%

开发者注意事项#

替换片段会根据提供的 prompt 和 tags 重新生成
生成的替换片段会自动与原音乐前后部分融合
生成的文件将保留 14 天
查询任务状态使用与生成音乐相同的接口:获取音乐详情

Callbacks

audioGenerated

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Body Params application/jsonRequired

Examples

Responses

🟢200
application/json
请求成功
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.kie.ai/api/v1/generate/replace-section' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "taskId": "2fac****9f72",
  "audioId": "e231****-****-****-****-****8cadc7dc",
  "prompt": "A calm and relaxing piano track.",
  "tags": "Jazz",
  "title": "Relaxing Piano",
  "negativeTags": "Rock",
  "infillStartS": 10.5,
  "infillEndS": 20.75,
  "fullLyrics": "[主歌1]\n原始歌词内容\n[副歌]\n此部分的修改歌词\n[主歌2]\n更多原始歌词",
  "callBackUrl": "https://example.com/callback",
  "lyrics": "[副歌]\n此部分的修改歌词",
  "variety": 1,
  "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"
    }
}
Previous
提升音乐风格
Next
生成音乐封面
Built with