استخدم Kling 3.0 motion-control عبر Rivya Public API v1 مع معرف النموذج kling-3-0-motion-control، والمدخلات المدعومة، والمعلمات، وقواعد Files API، والأرصدة، وأمثلة الاستجابة.

متاح عبر APIالجاهزيةفيديو

معرف نموذج API

kling-3-0-motion-control

المدخلات

file

Files API

مطلوب لأوضاع المراجع

الأرصدة الأساسية

per_output_second · 720p=20 · 1080p=27 · ⌈total⌉

القدرة

فيديو

الفوترة

METERED

حد prompt

2500 أحرف

عقد الطلب

أرسل معرف النموذج في المستوى الأعلى. توضع عناصر التحكم الخاصة بالنموذج داخل params.

المفتاح	النوع	مطلوب	الافتراضي	الوصف
model	string	نعم	kling-3-0-motion-control	استخدم معرف نموذج API وهو kling-3-0-motion-control.
prompt	string	نعم	-	الحد الأقصى لهذا النموذج هو 2500 حرفًا.
params	object	لا	-	كائن معلمات خاص بالنموذج. استخدم الصفوف أدناه لمعرفة المفاتيح المسموح بها.
client_request_id	string	لا	-	معرف اختياري من جهة العميل لتتبع الطلبات في نظامك.

معلمات النموذج

المفتاح	النوع	مطلوب	الافتراضي	النطاق	الخيارات	الوصف
mode	select	لا	720p	-	720p, 1080p	وضع التوليد
character_orientation	select	لا	video	-	video, image	يتحكم فيما إذا كان اتجاه الشخصية ينبغي أن يبقى أقرب إلى فيديو الحركة أو الصورة المرجعية.

سياسة الرفع

ارفع ملفات المراجع أولا، ثم ضع URL وduration token اللذين تم إرجاعهما داخل params.referenceMediaItems.

قاعدة المرجع

صورة مرجعية + فيديو حركة: مشروع دقيق من صورة واحدة + فيديو حركة واحد يحافظ على وضوح أدوار الهوية والحركة قياسي (720P): 20 × ثواني فيديو الحركة الموثقة؛ احترافي (1080P): 27 × الثواني

الحد الأقصى للملفات

أنواع الملفات المقبولة

image, video

Duration token

ينبغي أن تحمل مراجع الفيديو والصوت durationToken من /api/v1/files عندما يكون التحقق من المدة مطلوبا.

kind	الحد الأقصى للحجم	أنواع MIME
image	10 MB	image/jpeg, image/png
video	95 MB	video/mp4, video/quicktime

الطلب الأدنى

{
  "model": "kling-3-0-motion-control",
  "params": {
    "mode": "720p",
    "character_orientation": "video"
  }
}

طلب بملف مرجعي

{
  "model": "kling-3-0-motion-control",
  "params": {
    "mode": "720p",
    "character_orientation": "video",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

استجابة الإنشاء

تعيد نقطة نهاية الإنشاء معرف مهمة عامًا. استعلم عن نقطة نهاية الحالة حتى تنجح المهمة أو تفشل.

{
  "id": "task_kling_3_0_motion_control_example",
  "status": "queued",
  "model": "kling-3-0-motion-control",
  "reserved_credits": 27,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

الأخطاء الشائعة

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

تتطلب بعض الأوضاع رفع مراجع عبر Files API.

دمج API لنموذج Kling 3.0 motion-control