Kling VFX
Endpoint: POST https://vod.intl.tencentcloudapi.comAction: CreateAigcAudioTask
Kling VFX 是音效生成能力,可根据文本描述生成音效,也可为输入视频自动配上匹配画面的音效。
基本信息
| 项目 | 取值 |
|---|---|
| ModelName | Kling |
| SceneType | sfx |
仅填入提示词则为基于文本,放入视频则生成符合该视频的音效。
请求参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
ModelName | 必填 | String | 固定值 Kling |
SceneType | 必填 | String | sfx |
Prompt | 可选 | String | 用于基于文本的生成 |
VideoInfos.N | 可选 | Array | 基于视频的生成输入。Type / Url |
AdditionalParameters | 可选 | String | bgm_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_mode | ASMR 模式。强调细节音效 |
特殊设置
基于视频的音效
放入视频则生成符合该视频的音效。用 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_prompt | String | 描述背景音方向的提示词 |
asmr_mode | Boolean | ASMR 模式。强调细节音效,生成有沉浸感的结果 |
输入规格
| 项目 | 约束 |
|---|---|
| 视频格式 | MP4 / MOV |
| 文件大小 | 100MB 以下 |
| 视频长度 | 3.0 秒 ~ 20.0 秒 |
基于视频时 Duration 被忽略
基于视频的音效长度遵循输入视频长度。
输出格式
用 OutputConfig.OutputAudioFormat 指定输出格式。省略时使用模型默认值。
json
{
"OutputConfig": {
"StorageMode": "Temporary",
"OutputAudioFormat": "wav"
}
}附加选项
VideoInfos 以 [{ "Type": "Url", "Url": "..." }] 格式输入。