Kling Audio Generation

Channel type: Kling Extended (66) Gateway path: Text-to-Audio POST/GET https://maasunion.com/kling/v1/extended/audio/text-to-audio Video-to-Audio POST/GET https://maasunion.com/kling/v1/extended/audio/video-to-audio Official upstream: https://api-beijing.klingai.com (/v1/audio/text-to-audio, /v1/audio/video-to-audio)

Overview

The audio generation capability includes two types:

Text-to-Audio: generates sound effect audio based on a text prompt
Video-to-Audio: generates accompanying sound effect audio based on video content

Authentication

Header	Required	Description
`Authorization`	Yes	`Bearer {your_api_token}`
`Content-Type`	Required for POST	`application/json`

Text-to-Audio

POST https://maasunion.com/kling/v1/extended/audio/text-to-audio

Request Parameters

Parameter	Type	Required	Description
`prompt`	string	Yes	Sound effect description, e.g. "春节庆祝时的烟花声"
`duration`	number	No	Audio duration (seconds)
`external_task_id`	string	No	Custom task ID
`callback_url`	string	No	Callback URL

Request Example

curl --request POST \
  --url "https://maasunion.com/kling/v1/extended/audio/text-to-audio" \
  --header "Authorization: Bearer {your_api_token}" \
  --header "Content-Type: application/json" \
  --data '{
    "prompt": "春节庆祝时的烟花声",
    "duration": 3
  }'

Video-to-Audio

POST https://maasunion.com/kling/v1/extended/audio/video-to-audio

Request Parameters

Parameter	Type	Required	Description
`video_url`	string	Yes	Video URL
`prompt`	string	No	Sound effect description (optional)
`duration`	number	No	Audio duration (seconds)
`external_task_id`	string	No	Custom task ID
`callback_url`	string	No	Callback URL

Request Example

curl --request POST \
  --url "https://maasunion.com/kling/v1/extended/audio/video-to-audio" \
  --header "Authorization: Bearer {your_api_token}" \
  --header "Content-Type: application/json" \
  --data '{
    "video_url": "https://example.com/scene.mp4"
  }'

Create Response

{
  "code": 0,
  "message": "string",
  "request_id": "string",
  "data": {
    "task_id": "gateway_public_task_id",
    "task_status": "submitted",
    "created_at": 1722769557708,
    "updated_at": 1722769557708
  }
}

Query Task

GET https://maasunion.com/kling/v1/extended/audio/text-to-audio/{task_id} GET https://maasunion.com/kling/v1/extended/audio/video-to-audio/{task_id}

The query response contains audio URLs in task_result.audios:

{
  "code": 0,
  "data": {
    "task_id": "gateway_public_task_id",
    "task_status": "succeed",
    "task_result": {
      "audios": [
        {
          "url_mp3": "string",
          "url_wav": "string",
          "duration": "3"
        }
      ]
    },
    "final_unit_deduction": "string"
  }
}

Field	Description
`task_result.audios[].url_mp3`	MP3 audio URL
`task_result.audios[].url_wav`	WAV audio URL

Task Status

`task_status`	Meaning
`submitted`	Submitted
`processing`	Processing
`succeed`	Succeeded
`failed`	Failed

For more general information, see Kling Gateway Overview.