VOD APILast Updated 2026-09-05 19:30:41

Kling VFX

On this page

Endpoint: POST https://vod.intl.tencentcloudapi.com
Action: CreateAigcAudioTask

텍스트 설명이나 입력 영상에 맞는 효과음을 생성합니다.

기본 정보

항목	값
ModelName	`Kling`
SceneType	`sfx`

프롬프트만 넣으면 텍스트 기반, 영상을 넣으면 그 영상에 맞는 음향 효과를 만듭니다.

요청 파라미터

파라미터	필수	타입	설명
`ModelName`	필수	String	고정값 `Kling`
`SceneType`	필수	String	`sfx`
`Prompt`	선택	String	텍스트 기반 생성에 사용
`VideoInfos.N`	선택	Array	영상 기반 생성 입력. `Type` / `Url`
`AdditionalParameters`	선택	String	`bgm_prompt`(배경음 방향), `asmr_mode` 등

요청 예시

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

텍스트 기반 음향 효과

프롬프트만으로 음향 효과를 만듭니다. 길이는 OutputConfig.Duration으로 지정하며 [3, 10]초 범위입니다.

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

응답 예시

LANGUAGE
{
  "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에 지정합니다.

LANGUAGE
{
  "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으로 출력 형식을 지정합니다. 생략 시 모델 기본값을 사용합니다.

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

추가 옵션

VideoInfos는 [{ "Type": "Url", "Url": "..." }] 형식으로 입력합니다.