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

Kling Video · v3 · Pro · Motion Control

التكامل

معرّف النموذج kling-video/v3/pro/motion-control
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/kling-video/v3/pro/motion-control?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "character_orientation": "image"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

ملفات مثل المثال: ⁨‏1.68 $⁩ 1,680 رصيد API تُقاس ملفاتك قبل التشغيل تشغيله في هذه الصفحة

الحصول على مفتاح API
Kling من فيديو إلى فيديو مدخلات مرجعية #stylized#transform#editing

نقل الحركة ضمن فئة Pro، يطبّق حركة الشخصية في فيديو مرجعي على صورة شخصية

Kling · فيديو

ستظهر نتيجتك الأولى هنا

أنشئ طلبًا أدناه وشغّله باستخدام مفتاح API الخاص بك. تُنسخ المخرجات إلى تخزيننا، وتُحفظ إلى الأبد أو لمدة 7 أيام مجانًا.

إنشاء طلب

تُنشأ عناصر التحكم من مخطط النموذج. يتحدّث الرمز والسعر عند تغييرها.

0 / 2500
•مطلوب image_url
أفلت ملفًا، أو

عنوان URL لصورة مرجعية لتوليد الفيديو، بحد أقصى لحجم الملف قدره 10.0MB، وعرض وارتفاع يتراوح كل منهما بين 340px و3850px، ونسبة عرض إلى ارتفاع بين 0.40 و2.50. توجه هذه الصورة شخصيات الفيديو وخلفياته والعناصر الأخرى. بالنسبة إلى الشخصيات، احرص على وضوح نسب الجسم وعدم وجود حجب وتغطية تتجاوز 5% من مساحة الصورة.

•مطلوب video_url
أفلت ملفًا، أو

عنوان URL يشير إلى الفيديو الذي توجه حركات شخصيته المخرج؛ وينبغي أن يعرض شخصية بأسلوب واقعي وغير محجوبة، مع ظهور الرأس والجسم كاملًا أو الجزء العلوي منه. يحد إعداد character_orientation المدة إلى 10s عند استخدام 'image' أو 30s عند استخدام 'video'. حدود الملف: 100 MB كحد أقصى، وعرض وارتفاع بين 340px و3850px لكل منهما، ومدة بين 3.0s و30.05s.

character_orientation •مطلوب

مصدر اتجاه الشخصية: يطابق 'image' الصورة المرجعية، وهو أفضل لمتابعة حركات الكاميرا، بحد أقصى 10 ثوانٍ. للحركات المعقدة، يكون 'video' أفضل: إذ يطابق اتجاه الفيديو المرجعي ويسمح بمدة تصل إلى 30 ثانية.

متقدم enable_safety_checker · keep_original_sound · elements

ربط اختياري لعنصر الوجه لتحسين الحفاظ على الهوية في فيديو المخرج، بحد أقصى عنصر واحد مرفوع. استخدم @Element1 للإشارة إليه في الموجّه. لا يتوفر الربط إلا عند ضبط character_orientation على 'video'.

POST /run/kling-video/v3/pro/motion-control?wait=20 عرض السعر → ⁨‏1.68 $⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/kling-video/v3/pro/motion-control?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "character_orientation": "image"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

تشغيل هذا الطلب

يبقى مفتاحك في هذا المتصفح: لا يُرسل إلا إلى Doitong API ويُحفظ في localStorage فقط إذا فعّلت خيار التذكّر. الحصول على مفتاح API

حول Kling Video · v3 · Pro · Motion Control

يجمع صورة شخصية في `image_url` مع حركات من فيديو مرجعي في `video_url`. يجب تحديد `character_orientation`، الذي يختار ما إذا كان الاتجاه يتبع الصورة أو الفيديو. يدعم `prompt` اختيارياً حتى 2500 حرف، ويحتفظ `keep_original_sound` بالصوت المرجعي، ويمكن ربط عنصر وجهي واحد عبر `elements` للمساعدة في الحفاظ على الهوية.

المعاملات

أرسل الاسم الأساسي أو الاسم الأصلي، وليس كليهما. الأسماء الأساسية

الاسمالنوع الافتراضيمسموح الوصف
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
لا يمكن تعطيل فحوصات الأمان إلا بتفويض الحساب؛ وتخضع الطلبات غير المفوّضة للفحص دائمًا.
promptاختياري
النوعstring | null
≤ 2,500 حرف
image_urlمطلوب image
النوعurl · image
عنوان URL لصورة مرجعية لتوليد الفيديو، بحد أقصى لحجم الملف قدره 10.0MB، وعرض وارتفاع يتراوح كل منهما بين 340px و3850px، ونسبة عرض إلى ارتفاع بين 0.40 و2.50. توجه هذه الصورة شخصيات الفيديو وخلفياته والعناصر الأخرى. بالنسبة إلى الشخصيات، احرص على وضوح نسب الجسم وعدم وجود حجب وتغطية تتجاوز 5% من مساحة الصورة.
video_urlمطلوب video
النوعurl · video
عنوان URL يشير إلى الفيديو الذي توجه حركات شخصيته المخرج؛ وينبغي أن يعرض شخصية بأسلوب واقعي وغير محجوبة، مع ظهور الرأس والجسم كاملًا أو الجزء العلوي منه. يحد إعداد character_orientation المدة إلى 10s عند استخدام 'image' أو 30s عند استخدام 'video'. حدود الملف: 100 MB كحد أقصى، وعرض وارتفاع بين 340px و3850px لكل منهما، ومدة بين 3.0s و30.05s.
keep_original_soundاختياري
النوعboolean
الافتراضيtrue
يتحكم في الاحتفاظ بالصوت الأصلي للفيديو المرجعي.
character_orientationمطلوب
النوعenum
imagevideo
مصدر اتجاه الشخصية: يطابق 'image' الصورة المرجعية، وهو أفضل لمتابعة حركات الكاميرا، بحد أقصى 10 ثوانٍ. للحركات المعقدة، يكون 'video' أفضل: إذ يطابق اتجاه الفيديو المرجعي ويسمح بمدة تصل إلى 30 ثانية.
elementsاختياري
النوعobject[]
ربط اختياري لعنصر الوجه لتحسين الحفاظ على الهوية في فيديو المخرج، بحد أقصى عنصر واحد مرفوع. استخدم @Element1 للإشارة إليه في الموجّه. لا يتوفر الربط إلا عند ضبط character_orientation على 'video'.
elements[].frontal_image_urlاختياري
النوعurl · image
صورة أمامية تعرض العرض الرئيسي للعنصر. يجب ألا يتجاوز حجم الملف 50 MB؛ وألا يقل العرض والارتفاع عن 300px لكل منهما، مع نسبة عرض إلى ارتفاع بين 0.40 و2.50.
elements[].reference_image_urlsاختياري
النوعurl[] · image
وفّر 1–3 صور مرجعية إضافية تعرض زوايا مختلفة. يجب أن تتراوح نسبة عرض إلى ارتفاع كل صورة بين 0.40 و2.50، وأن يبلغ كل بُعد 300px على الأقل، وألا يتجاوز الحجم 50.0MB.
مطلوب الاسم الأساسي، مقبول أيضًا

تقبل معاملات الملفات عنوان URL عامًا يبدأ بـ https://، أو URI من نوع data: يصل حجمه إلى 10 MB، أو file_url لملف تم تحميله. الملفات

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "kling-video/v3/pro/motion-control",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 1680,
    "usd": "1.68",
    "charged": 1680,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "character_orientation": "image"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    }
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
ملفاتك، خيارككل outputs[].url هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 7 أيام مجانًا، وفق إعداد حسابك أو ?storage=.
البنية نفسها في كل نموذجtype وurl وcontent_type وwidth وheight وduration للصور والفيديو والصوت على حد سواء. output هو كائن النتائج الخاص بالنموذج.
حقول المخرجات
video
object {url, content_type, file_name, file_size}الفيديو الذي أنشأه النموذج.

مزيد من النماذج: من فيديو إلى فيديو

لوكلاء الذكاء الاصطناعي: تتوفر هذه الصفحة بصيغة Markdown على https://doitong.com/ar/developers/models/kling-video/v3/pro/motion-control.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt