Kling VFX

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

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

기본 정보

항목	값
ModelName	Kling
SceneType	sfx

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

요청 파라미터

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

bgm_prompt로 배경 음악 방향을 따로 지시할 수 있고 asmr_mode도 지원합니다.

요청 예시

curl -X POST https://mps.tencentcloudapi.com \
  -H "X-TC-Action: CreateAigcAudioTask" \
  -H "Content-Type: application/json" \
  -H "X-TC-Version: 2019-06-12" \
  -H "X-TC-Region: ap-guangzhou" \
  -H "Authorization: TC3-HMAC-SHA256 Credential=<SecretId>/<Date>/mps/tc3_request, SignedHeaders=content-type;host, Signature=<Signature>" \
  -d '{
  "ModelName": "Kling",
  "SceneType": "sfx",
  "Prompt": "rain and distant thunder, cinematic atmosphere",
  "Duration": 10,
  "Operator": "admin"
}'

curl -X POST https://mps.tencentcloudapi.com \
  -H "X-TC-Action: CreateAigcAudioTask" \
  -H "Content-Type: application/json" \
  -H "X-TC-Version: 2019-06-12" \
  -H "X-TC-Region: ap-guangzhou" \
  -H "Authorization: TC3-HMAC-SHA256 Credential=<SecretId>/<Date>/mps/tc3_request, SignedHeaders=content-type;host, Signature=<Signature>" \
  -d '{
  "ModelName": "Kling",
  "SceneType": "sfx",
  "VideoInfos": [
    {
      "Url": "https://<cdn>/source.mp4"
    }
  ],
  "AdditionalParameters": "{\"bgm_prompt\":\"tense cinematic ambience\",\"asmr_mode\":false}",
  "Operator": "admin"
}'

AdditionalParameters 필드:

필드	타입	설명
bgm_prompt	String	배경음 방향을 설명하는 프롬프트
asmr_mode	Boolean	ASMR 모드. 세부 음향을 강조해 몰입감 있는 결과를 만듭니다

응답 예시

{
  "Response": {
    "Status": "DONE",
    "Message": "ok",
    "AudioInfos": [
      {
        "Url": "https://aigc-output-audio-file-<id>.cos.<region>.myqcloud.com/<file>.mp3?q-sign-algorithm=sha1&..."
      }
    ],
    "VideoInfos": ,
    "RequestId": "<request-id>"
  }
}

특수 설정

추가 옵션

영상 기반에서는 Duration이 무시됩니다

영상 기반 음향 효과의 길이는 입력 영상 길이를 따릅니다.