MPS APILast Updated 2026-09-30

Kling VFX

On this page

Endpoint: POST https://mps.intl.tencentcloudapi.com
Action: 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도 지원합니다.

요청 예시

LANGUAGE
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 모드. 세부 음향을 강조해 몰입감 있는 결과를 만듭니다

응답 예시

LANGUAGE
{
  "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이 무시됩니다

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