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

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

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

تدفق المهمة

1

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

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

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

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

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

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

التفويضات

Authorization
string
header
مطلوب

Bearer token authentication. Use your CometAPI key.

الجسم

application/json
prompt
string
مطلوب

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

duration
integer
مطلوب

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

external_task_id
string

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

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
مطلوب