Skip to main content

ما الذي ستبنيه

سترسل مهمة Kling لتحويل النص إلى فيديو، وتخزّن معرّف المهمة المُعاد، وتستعلم عن نقطة نهاية مهمة Kling المطابقة، وتقرر متى تضيف callback_url للإشعارات الفورية.

المتطلبات الأساسية

  • مفتاح CometAPI API مخزّن في COMETAPI_KEY
  • Python 3.10+ مع requests، أو Node.js 18+
  • عامل على جانب الخادم للاستعلام الدوري أو نقطة نهاية HTTPS للـ webhooks

مفتاح API، عنوان URL الأساسي، والمصادقة

أنشئ مهمة Kling لتحويل النص إلى فيديو باستخدام:
استعلم عن المهمة باستخدام:
قم بالمصادقة باستخدام Bearer token:

أمثلة الشيفرة

استخدم علامات التبويب أدناه للحصول على أمثلة قابلة للنسخ في cURL وPython وNode.js.

شرح التدفق

إنشاء الفيديو باستخدام Kling يتم بشكل غير متزامن. تعيد نقطة النهاية الخاصة بالإنشاء data.task_id. نفّذ polling على GET /kling/v1/videos/text2video/<task_id> حتى تصل قيمة data.task_status إلى succeed أو failed. عند نجاح المهمة، انسخ رابط الأصل المكتمل من data.task_result إلى التخزين الخاص بك إذا كنت بحاجة إلى وصول دائم. أضف callback_url عندما تريد إرسال تحديثات حالة المهمة إلى نقطة نهاية HTTPS تتحكم بها. أبقِ polling متاحًا للمطابقة ومعالجة حالات فوات تسليم callback.

المعلمات الشائعة

استكشاف الأخطاء وإصلاحها / الأسئلة الشائعة

يستخدم Kling حقول JSON خاصة بالمزوّد مثل data.task_id وdata.task_status وdata.task_result. لا تقم بتحليلها كما لو كانت مسارات /v1/videos المتوافقة مع OpenAI.
استخدم polling محدودًا وتحقق من data.task_status_msg عند فشل المهمة. خزّن task ID لاستخدامه لاحقًا في التشخيص.
استخدم polling كخيار أساسي. أضف callback_url للتسليم الفوري، ثم طابق الحالة النهائية باستخدام polling.

الخطوات التالية