跳到内容

Kling VFX ​

更新时间

Endpoint: POST https://vod.intl.tencentcloudapi.comAction: CreateAigcAudioTask

Kling VFX 是音效生成能力,可根据文本描述生成音效,也可为输入视频自动配上匹配画面的音效。

基本信息 ​

项目取值
ModelNameKling
SceneTypesfx

仅填入提示词则为基于文本,放入视频则生成符合该视频的音效。

请求参数 ​

参数必填类型说明
ModelName必填String固定值 Kling
SceneType必填Stringsfx
Prompt可选String用于基于文本的生成
VideoInfos.N可选Array基于视频的生成输入。Type / Url
AdditionalParameters可选Stringbgm_prompt(背景音方向)、asmr_mode 等

请求示例 ​

json
{
  "SubAppId": 123456789,
  "ModelName": "Kling",
  "SceneType": "sfx",
  "Prompt": "rain falling on a tin roof, distant thunder"
}
json
{
  "SubAppId": 123456789,
  "ModelName": "Kling",
  "SceneType": "sfx",
  "VideoInfos": [
    {
      "Type": "Url",
      "Url": "https://<cos>/source.mp4"
    }
  ],
  "AdditionalParameters": "{\"bgm_prompt\": \"tense cinematic ambience\"}"
}

基于文本的音效 ​

仅凭提示词生成音效。长度以 OutputConfig.Duration 指定,范围为 [3, 10] 秒。

json
{
  "SubAppId": 123456789,
  "ModelName": "Kling",
  "SceneType": "sfx",
  "Prompt": "fireworks during a holiday celebration, distant crowd cheering",
  "OutputConfig": {
    "StorageMode": "Temporary",
    "Duration": 6
  }
}

响应示例 ​

json
{
  "AigcAudioTask": {
    "Status": "FINISH",
    "ErrCode": 0,
    "Output": {
      "AudioInfos": [
        {
          "FileUrl": "http://<host>.vod2.myqcloud.com/.../aigcAudioGenFile.mp3"
        }
      ]
    }
  }
}

视频输入约束 (video-to-sfx) ​

这是向 Kling video-to-sfx 放入视频时的约束。

项目取值
格式MP4 / MOV
文件大小100MB 以下
视频长度3.0 秒 ~ 20.0 秒
长度指定OutputConfig.Duration 被忽略,遵循视频长度

模型专用音频选项 ​

模型字段说明
Kling (video-to-sfx)bgm_prompt背景音乐生成提示词
Kling (video-to-sfx)asmr_modeASMR 模式。强调细节音效

特殊设置 ​

基于视频的音效 ​

放入视频则生成符合该视频的音效。用 VideoInfos 传递视频,背景音方向与 ASMR 模式指定在最顶层的 AdditionalParameters。

json
{
  "SubAppId": 123456789,
  "ModelName": "Kling",
  "SceneType": "sfx",
  "VideoInfos": [
    {
      "Type": "Url",
      "Url": "https://<cos>/source.mp4"
    }
  ],
  "Prompt": "gentle wind, distant birdsong, occasional footsteps, pages turning, rain tapping on the window",
  "AdditionalParameters": "{\"bgm_prompt\": \" healing piano with soft strings, warm and gentle, suitable for a drama scene\", \"asmr_mode\": true}",
  "OutputConfig": {
    "StorageMode": "Temporary"
  }
}

AdditionalParameters 字段:

字段类型说明
bgm_promptString描述背景音方向的提示词
asmr_modeBooleanASMR 模式。强调细节音效,生成有沉浸感的结果

输入规格 ​

项目约束
视频格式MP4 / MOV
文件大小100MB 以下
视频长度3.0 秒 ~ 20.0 秒

基于视频时 Duration 被忽略

基于视频的音效长度遵循输入视频长度。

输出格式 ​

用 OutputConfig.OutputAudioFormat 指定输出格式。省略时使用模型默认值。

json
{
  "OutputConfig": {
    "StorageMode": "Temporary",
    "OutputAudioFormat": "wav"
  }
}

附加选项 ​

VideoInfos 以 [{ "Type": "Url", "Url": "..." }] 格式输入。

基于 VitePress 构建 · 部署于腾讯云 EdgeOne Pages