Kling VFX

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

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

기본 정보

항목	값
ModelName	Kling
SceneType	sfx

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

요청 파라미터

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

요청 예시

{
  "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]초 범위입니다.

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

응답 예시

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

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

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

추가 옵션

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