PiAPI
HomeWorkspace
HomeWorkspace
Join Discord
  1. Kling
  • Get Started
    • Overview
    • Quickstart
    • Make Instruction: How to Use PiAPI to Build a Workflow on Make?
  • Endpoints
    • Song(Udio)
      • Song API Task Creation Examples
      • [Udio] Song Extend
      • Get Task
      • Create Task
      • [Udio] Generate Lyrics
    • Kling
      • Lipsync With PiAPI Kling API Examples
      • Motion Brush With PiAPI Kling API Example
      • Kling Elements Video Generation API
      • Kling Effects Video Generation
      • Cancel Task
        • Cancel Tasks
        • Cancel Task
      • Get Task
        GET
      • Create Task
        POST
      • Kling Virtual Try-On
        POST
      • Kling Effects
        POST
      • Kling Sound
        POST
    • Hailuo
      • Hailuo Director Mode Example
      • Generate Video
      • Get Task
    • Flux
      • Flux with LoRA and Controlnet
      • Available LoRA and Controlnet
      • Flux API with Redux Variation, Fill, Inpaint and Outpaint
      • Create Task
        • Text to Image
        • Image to Image
        • Kontext
      • Get task
    • AI Hug
      • Get Task
      • Create Task
    • LLM
      • Use Cases for GPT-4o Image API
      • How To Avoid Timeouts in Completion API
      • GPT-4o Image Generation API
      • LLM API | Basic Completions
      • Get Task
    • Midjourney
      • PiAPI Penalties on Midjourney Usage
      • Detailed Explaination on Midjourney Task Result
      • Midjourney V7 API Instructions
      • Create Task
        • Imagine
        • Upscale
        • Variation
        • Reroll
        • Describe
        • Seed
        • Blend
        • Inpaint
        • Outpaint
        • Pan
      • Cancel Task
        • Cancel Task
        • Cancel Tasks
      • Get Task
    • Faceswap
      • Multi Faceswap
      • Image Faceswap
      • Video Faceswap
      • Get Task
    • TTS
      • Zeroshot Text-to-Speech F5-TTS
      • Get Task
    • Trellis
      • Create Task
      • Get Task
    • Luma Dream Machine
      • Cancel Task
        • Cancel Tasks
        • Cancel Task
      • Create Task
      • Get Task
    • WanX
      • Generate WanX Task with LoRA Using PiAPI
      • Available LoRA Types for Wanx
      • Use Cases for Wanx LoRA
      • Use Cases for Wanx Control Camera
      • Create Task
      • Get Task
    • Skyreels
      • Create Task
      • Get Task
    • Framepack
      • Create Task
      • Get Task
    • Hunyuan Video
      • How to Make a Hunyuan API Call
      • Get Task
      • Generate Video
    • Mmaudio
      • Get Task
      • Generate Audio
    • DiffRhythm
      • Generate Audio
      • Get Task
    • Ace Step
      • Create Task
        • Text to Audio
        • Audio to Audio
        • Audio Edit
        • Audio Extend
      • Get Task
    • Tools
      • File Upload API
      • Video Upscale
      • Video Upscale-Get Task
      • Remove Background API
      • Remove Background-Get Task
      • Segment With Prompt API
      • Segment With Prompt API-Get Task
      • Image Upscale(Super Resolution) API
      • Image Upscale-Get Task
    • PiAPI Account Management
      • PiAPI Account Info
      • Task List Info
      • User Task History
  • Resources
    • Change Log
    • Output Storage
    • Unified API Schema
    • Webhook
    • Bulk Generation Service
    • Billings
    • PiAPI MCP Server
    • Workspace Manual
      • Host-your-account (HYA) | Back-up Account
      • Host-your-account (HYA) | Debug Checklist
      • Host-your-account (HYA) | Connected Account Status
    • Announcements
      • PiAPI 2025 January 1st Pricing Update
  • Legacy Documentation
    • Midjourney
      • Midjourney Webhook
      • Imagine
      • Reroll
      • Upscale
      • Variation
      • Inpaint
      • Outpaint
      • Pan
      • Describe
      • Blend
      • Seed
      • Fetch
      • Multi Fetch
      • Cancel
    • Face Swap
      • Video Faceswap
      • Multi-face-swap
      • Fetch
    • Dream Machine
      • Video Generation
      • Video Extend
      • Get Video Generation
    • Kling
      • Video Generation
      • Video Extend
      • Get Video Generation
  1. Kling

Kling Sound

POST
https://api.piapi.ai/api/v1/task
This is the api for Kling's Sound, $0.07 for each generation(4 outputs) for PPU.
There are two generation methods: text to audio, add audio to video.
For text to audio method, you need to provide text prompt and duration(5s/10s) for generation. The output will be 4 mp3 files.
For add audio to video method, you can add audio to your generated kling video, thus need to provide the origin task id of the video generation. The output will be 4 mp4 files.

Request

Header Params
x-api-key
string 
required
you api key
Body Params application/json
model
enum<string> 
required
should be kling
Allowed value:
kling
Default:
kling
task_type
enum<string> 
required
should be sound
Allowed value:
sound
Default:
effects
input
object 
required
the input param of the task
prompt
string 
optional
text prompt used to generate audio, only needed in text to audio generation.
duration
enum<integer> 
optional
duration of output audio, only needed in text to audio generation. Default as 10
Allowed values:
510
Default:
10
origin_task_id
string 
optional
the task id for kling video generation
config
object 
optional
webhook_config
object 
optional
Webhook provides timely task notifications. Check PiAPI webhook for detail.
service_mode
enum<string> 
optional
This allows users to choose whether this specific task will get processed under PAYG or HYA mode. If unspecified, then this task will get processed under whatever mode (PAYG or HYA)
the user chose on the workspace setting of your account.
public means this task will be processed under PAYG mode.
private means this task will be processed under HYA mode.
Allowed values:
publicprivate
Examples
{
    "model": "kling",
    "task_type": "sound",
    "input": {
        "prompt": "The audio contains the sound of a lively violin playing a marching tune.",
        "duration": 10
    },
    "config": {
        "service_mode": "public",
        "webhook_config": {
            "endpoint": "https://webhook.site/29649907-dab6-40f5-b059-b11b7a81fec1",
            "secret": ""
        }
    }
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location --request POST 'https://api.piapi.ai/api/v1/task' \
--header 'x-api-key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "kling",
    "task_type": "sound",
    "input": {
        "prompt": "The audio contains the sound of a lively violin playing a marching tune.",
        "duration": 10
    },
    "config": {
        "service_mode": "public",
        "webhook_config": {
            "endpoint": "https://webhook.site/29649907-dab6-40f5-b059-b11b7a81fec1",
            "secret": ""
        }
    }
}'

Responses

🟢200Success
application/json
Body
object {0}
Example
{
    "timestamp": 1751439504,
    "data": {
        "task_id": "f8dacb0f-c786-4f8a-beb2-d435a343c928",
        "model": "kling",
        "task_type": "sound",
        "status": "completed",
        "config": {
            "service_mode": "public",
            "webhook_config": {
                "endpoint": "https://webhook.site/29649907-dab6-40f5-b059-b11b7a81fec1",
                "secret": ""
            }
        },
        "input": {
            "duration": 10,
            "prompt": "The audio contains the sound of a lively violin playing a marching tune."
        },
        "output": {
            "type": "kwave_txt2audio",
            "status": 99,
            "works": [
                {
                    "content_type": "audio",
                    "status": 99,
                    "type": "kwave_txt2audio",
                    "cover": {
                        "resource": "https://s21-kling.klingai.com/kimg/EMXN1y8qSQoGdXBsb2FkEg55bGFiLXN0dW50LXNncBova2xpbmcvYXVkaW8tcmVzb3VyY2UvYXVkaW8tY292ZXIvY292ZXItMngtNi5wbmc.origin?x-kcdn-pid=112372",
                        "resource_without_watermark": "",
                        "height": 414,
                        "width": 414,
                        "duration": 0
                    },
                    "video": {
                        "resource": "",
                        "resource_without_watermark": "",
                        "height": 0,
                        "width": 0,
                        "duration": 0
                    },
                    "audio": {
                        "resource": "https://v21-kling.klingai.com/bs2/upload-ylab-stunt-sgp/se/ai_portal_sgp_kwave_txt2audio/fada6732-7c31-4960-aff5-ef2ea45e0abc_audio_mp3.mp3?x-kcdn-pid=112372",
                        "resource_without_watermark": "https://storage.theapi.app/videos/283410775300625.mp3",
                        "height": 414,
                        "width": 414,
                        "duration": 10057
                    }
                },
                {
                    "content_type": "audio",
                    "status": 99,
                    "type": "kwave_txt2audio",
                    "cover": {
                        "resource": "https://s21-kling.klingai.com/kimg/EMXN1y8qSQoGdXBsb2FkEg55bGFiLXN0dW50LXNncBova2xpbmcvYXVkaW8tcmVzb3VyY2UvYXVkaW8tY292ZXIvY292ZXItMngtMy5wbmc.origin?x-kcdn-pid=112372",
                        "resource_without_watermark": "",
                        "height": 414,
                        "width": 414,
                        "duration": 0
                    },
                    "video": {
                        "resource": "",
                        "resource_without_watermark": "",
                        "height": 0,
                        "width": 0,
                        "duration": 0
                    },
                    "audio": {
                        "resource": "https://v21-kling.klingai.com/bs2/upload-ylab-stunt-sgp/se/ai_portal_sgp_kwave_txt2audio/c9347cf8-f240-4b3e-b864-9db6ee9bdcde_audio_mp3.mp3?x-kcdn-pid=112372",
                        "resource_without_watermark": "https://storage.theapi.app/videos/283410775305628.mp3",
                        "height": 414,
                        "width": 414,
                        "duration": 10057
                    }
                },
                {
                    "content_type": "audio",
                    "status": 99,
                    "type": "kwave_txt2audio",
                    "cover": {
                        "resource": "https://s21-kling.klingai.com/kimg/EMXN1y8qSQoGdXBsb2FkEg55bGFiLXN0dW50LXNncBova2xpbmcvYXVkaW8tcmVzb3VyY2UvYXVkaW8tY292ZXIvY292ZXItMngtMi5wbmc.origin?x-kcdn-pid=112372",
                        "resource_without_watermark": "",
                        "height": 414,
                        "width": 414,
                        "duration": 0
                    },
                    "video": {
                        "resource": "",
                        "resource_without_watermark": "",
                        "height": 0,
                        "width": 0,
                        "duration": 0
                    },
                    "audio": {
                        "resource": "https://v21-kling.klingai.com/bs2/upload-ylab-stunt-sgp/se/ai_portal_sgp_kwave_txt2audio/b7ed5a41-7fa5-442e-a75e-2cd5ef494b92_audio_mp3.mp3?x-kcdn-pid=112372",
                        "resource_without_watermark": "https://storage.theapi.app/videos/283410775306630.mp3",
                        "height": 414,
                        "width": 414,
                        "duration": 10057
                    }
                },
                {
                    "content_type": "audio",
                    "status": 99,
                    "type": "kwave_txt2audio",
                    "cover": {
                        "resource": "https://s21-kling.klingai.com/kimg/EMXN1y8qSQoGdXBsb2FkEg55bGFiLXN0dW50LXNncBova2xpbmcvYXVkaW8tcmVzb3VyY2UvYXVkaW8tY292ZXIvY292ZXItMngtMy5wbmc.origin?x-kcdn-pid=112372",
                        "resource_without_watermark": "",
                        "height": 414,
                        "width": 414,
                        "duration": 0
                    },
                    "video": {
                        "resource": "",
                        "resource_without_watermark": "",
                        "height": 0,
                        "width": 0,
                        "duration": 0
                    },
                    "audio": {
                        "resource": "https://v21-kling.klingai.com/bs2/upload-ylab-stunt-sgp/se/ai_portal_sgp_kwave_txt2audio/82561761-b10e-498b-9af3-73824edbc2dc_audio_mp3.mp3?x-kcdn-pid=112372",
                        "resource_without_watermark": "https://storage.theapi.app/videos/283410775306633.mp3",
                        "height": 414,
                        "width": 414,
                        "duration": 10057
                    }
                }
            ]
        },
        "meta": {
            "created_at": "2025-07-02T06:54:49.26273132Z",
            "started_at": "2025-07-02T06:54:49.971638303Z",
            "ended_at": "2025-07-02T06:58:24.599459321Z",
            "usage": {
                "type": "point",
                "frozen": 700000,
                "consume": 700000
            },
            "is_using_private_pool": false
        },
        "detail": null,
        "logs": [],
        "error": {
            "code": 0,
            "raw_message": "",
            "message": "",
            "detail": null
        }
    }
}
Modified at 2025-07-02 07:06:54
Previous
Kling Effects
Next
Hailuo Director Mode Example