الانتقال إلى المحتوى الرئيسي
استخدم callback_url في مهام Kling غير المتزامنة عندما تريد تسليمًا بالدفع بدلًا من الاعتماد على الاستطلاع فقط.

أين يُستخدم

  • مهام تحويل النص إلى فيديو وتحويل الصورة إلى فيديو
  • مهام Avatar وتأثيرات الفيديو
  • مسارات Kling غير المتزامنة الأخرى التي توفّر حقل callback_url اختياريًا

سلوك التسليم

  • يرسل Kling طلبات POST إلى endpoint الاستدعاء العكسي لديك كلما تغيّرت حالة المهمة
  • الحالات الشائعة هي submitted وprocessing وsucceed وfailed
  • يمكن أن تتضمن الحمولة task_result.images أو task_result.videos بحسب نوع المهمة
  • أبقِ الاستطلاع اليدوي متاحًا لأغراض المطابقة أو إعادة المحاولة أو التعامل مع webhooks الفائتة

قائمة التحقق للتكامل

  • استخدم endpoint استدعاء عكسي عبر HTTPS وتتحكم فيه
  • اقبل تحديثات الحالة المتكررة لنفس معرّف المهمة
  • تعامل مع تسليم webhook على أنه غير متزامن ومتسق بمرور الوقت
  • احفظ عناوين URL النهائية للأصول بسرعة إذا كان سير العمل لديك يحتاج إلى تخزين دائم
{
  "task_id": "string",
  "task_status": "string",
  "task_status_msg": "string",
  "created_at": 1722769557708,
  "updated_at": 1722769557708,
  "task_result": {
    "images": [
      {
        "index": 0,
        "url": "https://example.com/generated-image.png"
      }
    ],
    "videos": [
      {
        "id": "string",
        "url": "https://example.com/generated-video.mp4",
        "duration": "5"
      }
    ]
  }
}