تخطَّ إلى المحتوى

مستندات كلينج للتحكم في الحركة API

مستندات Kling Motion Control API للصور بالإضافة إلى سير عمل الفيديو المتحرك

مرجع التحكم في الحركة Kling

مستندات Kling Motion Control API للصور بالإضافة إلى سير عمل الفيديو المتحرك

استخدم هذا الدليل للتكامل Kling 2.6 التحكم في الحركة من خلال UlazAI API. يستخدم التكامل الحالي model_slug="kling_3_0_motion_control" على /api/v1/video-studio/generate/أو مسار التوافق /api/v1/generate/video/ مع video_model="kling_3_0_motion_control". ترسل بالضبط عنوان URL لصورة واحدة, عنوان URL لفيديو متحرك واحدو prompt ووضع الجودة 720p أو 1080p.

نقاط النهاية الأساسية

/api/v1/video-studio/generate/

/api/v1/video-studio/status/{job_id}/

/api/v1/generate/video/

الدعم الحالي

عنوان URL واحد للصورة + عنوان URL واحد للفيديو المتحرك

إخراج 720p أو 1080p

من 3 إلى 15 ثانية

ملاحظة الطريق: عنوان URL العام لا يزال يقول kling-2-6-motion-control-api-docs، ولكن سبيكة النموذج الحالي للتكاملات المباشرة هي kling_3_0_motion_control.
استخدم نقطة نهاية التوافق فقط إذا كنت تقوم بالفعل بالشحن مقابل الفيديو القديم المعتمد API.

المصادقة

قم بإرسال رمز حامل أو مفتاح API عند كل طلب.

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

طلب قانوني

يذهب هذا الطلب إلى /api/v1/video-studio/generate/. إنه عقد API المفضل لعمليات التكامل الجديدة.

{
  "model_slug": "kling_3_0_motion_control",
  "prompt": "No distortion, the character's movements are consistent with the video.",
  "input_image_urls": ["https://example.com/character.png"],
  "input_video_urls": ["https://example.com/motion.mp4"],
  "character_orientation": "video",
  "quality_mode": "720p",
  "duration_seconds": 15
}

مرجع ميداني

الميدان مطلوب ملاحظات
model_slug نعم يجب أن يكون kling_3_0_motion_control
prompt نعم الحد الأقصى 2500 حرف
input_image_urls نعم عنوان URL واحد للصورة العامة بالضبط
input_video_urls نعم عنوان URL واحد فقط لفيديو الحركة العامة
character_orientation لا استخدم video لمتابعة اتجاه مقطع الحركة أو image للحفاظ على تأطير الشخصية التي تم تحميلها
quality_mode نعم استخدم 720p أو 1080p
duration_seconds نعم عدد صحيح من 3 إلى 15. يستخدم التسعير هذه المدة.

طلب التوافق القديم

يذهب هذا الطلب إلى /api/v1/generate/video/. استخدمه إذا كنت تتكامل بالفعل مع الفيديو القديم المعتمد API.

{
  "video_model": "kling_3_0_motion_control",
  "prompt": "No distortion, the character's movements are consistent with the video.",
  "source_image_urls": ["https://example.com/character.png"],
  "video_urls": ["https://example.com/motion.mp4"],
  "character_orientation": "video",
  "quality_mode": "720p",
  "duration_seconds": 15
}

أمثلة على الاستجابة

الكنسي توليد الاستجابة

{
  "success": true,
  "job_ids": ["8990f846-f6f0-4ff1-a298-d0a72d49e7ad"],
  "credits_remaining_total": 438
}

تراث توليد الاستجابة

{
  "success": true,
  "data": {
    "generation_id": "7f8cfd64-5b91-4a31-a987-e0ea8fd9d0a1",
    "generation_type": "video",
    "video_model": "kling30_motion",
    "mode": "image-to-video",
    "status": "processing",
    "credits_used": 300
  }
}

استطلاع الحالة

GET /api/v1/video-studio/status/{job_id}/
GET /api/v1/generate/{generation_id}/

التسعير

يعتمد تسعير التحكم في الحركة على المدة.

720p
20 الاعتمادات / الثانية
1080p
27 الاعتمادات / الثانية

الاعتمادات والنماذج والحالة