Langsung ke konten utama
POST
/
kling
/
v1
/
audio
/
text-to-audio
Create a Kling text-to-audio task
curl --request POST \
  --url https://api.cometapi.com/kling/v1/audio/text-to-audio \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "Soft ambient ocean waves at sunrise.",
  "duration": 5
}
'
{
  "code": 0,
  "message": "SUCCEED",
  "data": {
    "task_id": "861254119619698760",
    "task_status": "submitted",
    "task_info": {},
    "created_at": 1773367502225,
    "updated_at": 1773367502225
  }
}
Gunakan endpoint ini untuk menghasilkan klip audio singkat dari prompt teks melalui Kling.

Sebelum memanggilnya

  • Jaga agar prompt tetap ringkas dan langsung
  • Mulai dengan duration antara 3 dan 10 detik
  • Perlakukan callback_url dan external_task_id sebagai bantuan integrasi opsional, bukan persyaratan inti

Alur tugas

1

Kirim tugas audio

Kirim prompt teks dan durasi, lalu simpan id tugas yang dikembalikan.
2

Poll tugas

Lanjutkan dengan Kueri Individual menggunakan path kueri audio Kling hingga tugas mencapai status terminal.
3

Simpan output audio

Simpan aset audio final jika Anda membutuhkannya setelah melewati jangka waktu penyediaan dari penyedia.
Untuk referensi parameter lengkap, lihat dokumentasi resmi Kling.

Otorisasi

Authorization
string
header
wajib

Bearer token authentication. Use your CometAPI key.

Body

application/json
prompt
string
default:Hello
wajib

Text prompt describing the audio to generate. Max 200 characters.

duration
integer
default:5
wajib

Duration of the generated audio in seconds. Range: 3.0–10.0, supports one decimal place.

external_task_id
string
default:audio-text-task-001

Optional user-defined task ID for your own tracking. Does not replace the system-generated task ID. Must be unique per account.

callback_url
string
default:https://example.com/webhook

Webhook URL for task status notifications. The server sends a callback when the task status changes.

Respons

200 - application/json

Task accepted.

code
integer
wajib

Error code; specific error code definition

message
string
wajib

Error message

data
object
wajib