ما الذي ستبنيه
سترسل مهمة Kling لتحويل النص إلى فيديو، وتخزّن معرّف المهمة المُعاد، وتستعلم عن نقطة نهاية مهمة Kling المطابقة، وتقرر متى تضيفcallback_url للإشعارات الفورية.
المتطلبات الأساسية
- مفتاح CometAPI API مخزّن في
COMETAPI_KEY - Python 3.10+ مع
requests، أو Node.js 18+ - عامل على جانب الخادم للاستعلام الدوري أو نقطة نهاية HTTPS للـ webhooks
مفتاح API، عنوان URL الأساسي، والمصادقة
أنشئ مهمة Kling لتحويل النص إلى فيديو باستخدام:أمثلة الشيفرة
استخدم علامات التبويب أدناه للحصول على أمثلة قابلة للنسخ في 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.
المعلمات الشائعة
استكشاف الأخطاء وإصلاحها / الأسئلة الشائعة
شكل الاستجابة يختلف عن مسارات الفيديو الخاصة بـ OpenAI
شكل الاستجابة يختلف عن مسارات الفيديو الخاصة بـ OpenAI
يستخدم Kling حقول JSON خاصة بالمزوّد مثل
data.task_id وdata.task_status وdata.task_result. لا تقم بتحليلها كما لو كانت مسارات /v1/videos المتوافقة مع OpenAI.المهمة لا تصل أبدًا إلى succeed
المهمة لا تصل أبدًا إلى succeed
استخدم polling محدودًا وتحقق من
data.task_status_msg عند فشل المهمة. خزّن task ID لاستخدامه لاحقًا في التشخيص.هل يجب أن أستخدم callback_url أم polling
هل يجب أن أستخدم callback_url أم polling
استخدم polling كخيار أساسي. أضف
callback_url للتسليم الفوري، ثم طابق الحالة النهائية باستخدام polling.الخطوات التالية
- اقرأ مرجع API لتحويل النص إلى فيديو في Kling.
- نفّذ polling باستخدام الحصول على مهمة Kling.
- اضبط callbacks باستخدام استخدام عناوين URL الخاصة بـ Kling callback.
- اعثر على نماذج فيديو Kling في Models.
- راجع استخدام polling وwebhooks لإنشاء الفيديو.
- قدّر تكلفة المهمة باستخدام تقدير تكلفة الطلب قبل استدعاء model.