Chuyển đến nội dung chính
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
  }
}
Sử dụng endpoint này để tạo một đoạn âm thanh ngắn từ Prompt văn bản thông qua Kling.

Trước khi gọi

  • Giữ prompt ngắn gọn và trực tiếp
  • Bắt đầu với duration trong khoảng từ 3 đến 10 giây
  • Xem callback_urlexternal_task_id như các công cụ hỗ trợ tích hợp tùy chọn, không phải yêu cầu cốt lõi

Luồng tác vụ

1

Gửi tác vụ âm thanh

Gửi Prompt văn bản và thời lượng, sau đó lưu task id được trả về.
2

Thăm dò tác vụ

Tiếp tục với Truy vấn riêng lẻ bằng đường dẫn truy vấn âm thanh của Kling cho đến khi tác vụ đạt đến trạng thái kết thúc.
3

Lưu trữ đầu ra âm thanh

Lưu lại tài nguyên âm thanh cuối cùng nếu bạn cần dùng nó sau khoảng thời gian nhà cung cấp còn cho phép tải về.
Việc xác thực trực tiếp vào ngày 2026-03-13 đã xác nhận rằng một request tối giản chỉ với promptduration đã được chấp nhận và trả về task_status: submitted.
Để xem tài liệu tham chiếu tham số đầy đủ, hãy xem tài liệu Kling chính thức.

Ủy quyền

Authorization
string
header
bắt buộc

Bearer token authentication. Use your CometAPI key.

Nội dung

application/json
prompt
string
mặc định:Hello
bắt buộc

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

duration
integer
mặc định:5
bắt buộc

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

external_task_id
string
mặc định: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
mặc định:https://example.com/webhook

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

Phản hồi

200 - application/json

Task accepted.

code
integer
bắt buộc

Error code; specific error code definition

message
string
bắt buộc

Error message

data
object
bắt buộc