الانتقال إلى المحتوى الرئيسي
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
  }
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

استخدم نقطة النهاية هذه لإنشاء مقطع صوتي قصير من مطالبة نصية عبر Kling.

قبل استدعائها

  • اجعل prompt موجزًا ومباشرًا
  • ابدأ باستخدام duration بين 3 و10 ثوانٍ
  • اعتبر callback_url وexternal_task_id مساعدين اختياريين للتكامل، وليسا متطلبات أساسية

تدفق المهمة

1

إرسال المهمة الصوتية

أرسل المطالبة النصية والمدة، ثم احفظ معرّف المهمة المُعاد.
2

الاستعلام عن المهمة

تابع باستخدام Individual Queries عبر مسار استعلام الصوت في Kling حتى تصل المهمة إلى حالة نهائية.
3

تخزين المخرجات الصوتية

احتفظ بالأصل الصوتي النهائي إذا كنت بحاجة إليه بعد انتهاء نافذة التسليم الخاصة بالمزوّد.
للاطلاع على المرجع الكامل للمعلمات، راجع وثائق Kling الرسمية.

التفويضات

Authorization
string
header
مطلوب

Bearer token authentication. Use your CometAPI key.

الجسم

application/json
prompt
string
افتراضي:Hello
مطلوب

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

duration
integer
افتراضي:5
مطلوب

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

external_task_id
string
افتراضي: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
افتراضي:https://example.com/webhook

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

الاستجابة

200 - application/json

Task accepted.

code
integer
مطلوب

Error code; specific error code definition

message
string
مطلوب

Error message

data
object
مطلوب