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

Kling 4.0 Reference to Video

التكامل

معرّف النموذج kling/v4/reference-to-video
# 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/v4/reference-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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.175 $⁩ 1,175 رصيد API تُقاس ملفاتك قبل التشغيل تشغيله في هذه الصفحة

الحصول على مفتاح API
Kling من مرجع إلى فيديو مدخلات مرجعية3–30 ثحتى 1080p #reference-to-video#multi-shot#image-reference#video-reference

ينشئ فيديوهات مدتها من 3 إلى 30 ثانية تحافظ على مظهر ما يصل إلى 10 صور مرجعية و5 فيديوهات مرجعية و7 عناصر

أُنشئت على Doitong

أعمال عامة أُنشئت باستخدام Kling 4.0 من مجتمع Doitong. أعد استخدام موجّه بنقرة واحدة.

الأعمال العامة المعروضة: 16
Ultra-realistic cinematic video of a young adult woman walking naturally toward the camera while ... فيديو

Ultra-realistic cinematic video of a young adult woman walking naturally toward the camera while speaking, with realistic facial expressions and synchronized lip movements, as if she is promoting something to the viewer. She maintains eye contact with the camera, smiles slightly, and uses subtle...

Slow, subtle push-in on the woman's face. The light from the laptop flickers softly across her ey... فيديو

Slow, subtle push-in on the woman's face. The light from the laptop flickers softly across her eyes and cheeks, as if the blurry image on the screen is changing. Her eyes move slightly as she studies the screen, and she takes one slow, tense breath. Behind her, shadows of the snowstorm move...

The enormous ancient dragon descends slowly toward the snowy cliff and lands at the cave mouth. I... فيديو

The enormous ancient dragon descends slowly toward the snowy cliff and lands at the cave mouth. Its huge dark leathery wings beat twice with slow, heavy strokes, sending snow swirling off the cliff in big clouds. Then it folds its wings and settles on the rock, the giant elk still held in its...

**Duration: 5 seconds | Aspect ratio: 16:9 | Children's YouTube Intro | Video with Audio** Animat... فيديو

**Duration: 5 seconds | Aspect ratio: 16:9 | Children's YouTube Intro | Video with Audio** Animate the provided image into a bright, magical, energetic, professional YouTube intro for a children's entertainment channel, with perfectly synchronized sound effects, cheerful music, and a cute child's...

Authentic 1990s wide-angle film footage. The left man slowly pulls one wooden block from the Jeng... فيديو

Authentic 1990s wide-angle film footage. The left man slowly pulls one wooden block from the Jenga tower. As the block comes out, the tower naturally loses balance and realistically collapses onto the table. Frustrated, he angrily sweeps all the fallen wooden blocks off the table with both hands....

Thermal-camera view of a snowy mountain cliff at night in false-color, deep blue and violet cold ... فيديو

Thermal-camera view of a snowy mountain cliff at night in false-color, deep blue and violet cold rock, a huge orange-white heat shape hidden inside a rock crevice, two small bright amber spots glowing like eyes, faint noise grain. Cinematic videorealistic, ultra detailed, 16:9, volumetric light,...

**Duration: 4 seconds | Aspect ratio: 16:9 | Children's YouTube Intro | Video with Audio** Animat... فيديو

**Duration: 4 seconds | Aspect ratio: 16:9 | Children's YouTube Intro | Video with Audio** Animate the provided image into a bright, magical, energetic, professional YouTube intro for a children's entertainment channel, with perfectly synchronized sound effects, cheerful music, and a cute child's...

**Duration: 4 seconds | Aspect ratio: 16:9 | Children's YouTube Intro | Video with Audio** Animat... فيديو

**Duration: 4 seconds | Aspect ratio: 16:9 | Children's YouTube Intro | Video with Audio** Animate the provided image into a bright, magical, energetic, professional YouTube intro for a children's entertainment channel, with perfectly synchronized sound effects, cheerful music, and a cute child's...

إنشاء طلب

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

88 / 2500

تعليمات توليد تستوفي شرط توفير `prompt` أو `multi_prompt`. للإشارة إلى المداخل الموفّرة، استخدم @Image1 و@Video1 و@Element1 وما إلى ذلك.

video_urls
أفلت ملفًا، أو · حتى 5

ما يصل إلى 5 فيديوهات مرجعية، يُشار إليها باستخدام @Video1 و@Video2 وما إلى ذلك؛ تستمر مدة كل منها 3–30 ثانية (30.05 ثانية كحد أقصى)، ولا يمكن أن تتجاوز مدتها الإجمالية مع فيديوهات العناصر 30 ثانية. يجب ألا يتجاوز حجم كل ملف 300 MB، وأن يتراوح العرض والارتفاع بين 700 px و4553 px لكل منهما. يجب أن تتراوح نسبة العرض إلى الارتفاع بين 0.40 و2.50، ومعدل الإطارات بين 23.9 و60.05 FPS.

resolution الافتراضي 1080p

دقة المخرج.

aspect_ratio الافتراضي 16:9

أبعاد الفيديو، تُحدد صراحةً أو تُستنتج من المراجع عبر اختيار 'auto'.

الافتراضي 5

طول الفيديو بالثواني، من 3 إلى 30.

متقدم image · images · multi_prompt · elements
start_image_url
أفلت ملفًا، أو

صورة اختيارية للإطار الأول تُحتسب ضمن حد الصور المرجعية. الحد الأقصى لحجم الملف هو 30.0 MB؛ ويجب ألا يقل العرض والارتفاع عن 300 px لكل منهما، مع نسبة عرض إلى ارتفاع بين 0.40 و2.50.

image_urls
أفلت ملفًا، أو · حتى 10

صور مرجعية يُشار إليها باستخدام @Image1 و@Image2 وما إلى ذلك، بحد أقصى 10 صور. يقتصر حجم كل ملف على 30.0 MB، ويجب أن يبلغ كل بُعد 300 px على الأقل، وأن تتراوح نسبة العرض إلى الارتفاع بين 0.40 و2.50.

تعليمات توليد لقطة تلو الأخرى، حيث يحدد كل موجّه لقطة واحدة تسهم مدتها في الطول الإجمالي للفيديو.

مجموعة تضم ما يصل إلى 7 شخصيات أو كائنات، ويمكن أن يتضمن 3 منها على الأكثر `voice_id`، وأن يستخدم 3 منها على الأكثر فيديو. أشر إلى هذه العناصر باستخدام @Element1 و@Element2 وما إلى ذلك.

POST /run/kling/v4/reference-to-video?wait=20 عرض السعر → ⁨‏1.175 $⁩
# 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/v4/reference-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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 4.0 Reference to Video

ينشئ فيديو من `prompt` نصي بالإضافة إلى الصور المرجعية والفيديوهات المرجعية وعناصر الشخصيات أو الكائنات، التي يُشار إليها في `prompt` بصيغة @Image1 أو @Video1 أو @Element1. تتراوح المدة من 3 إلى 30 ثانية (الافتراضي 5)، مع إخراج بدقة 720p أو 1080p ونسب أبعاد auto أو 16:9 أو 9:16 أو 1:1 أو 21:9. استخدم `multi_prompt` لتوفير مطالبات لكل لقطة، وفي هذه الحالة يكون الطول الإجمالي مجموع مدد اللقطات. الحدود هي 10 صور و5 فيديوهات مدة كل منها من 3 إلى 30s و7 عناصر، ويمكن لما يصل إلى 3 منها أن تتضمن صوتًا.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
promptاختياري
النوعstring | null
≤ 2,500 حرف
تعليمات توليد تستوفي شرط توفير `prompt` أو `multi_prompt`. للإشارة إلى المداخل الموفّرة، استخدم @Image1 و@Video1 و@Element1 وما إلى ذلك.
multi_promptاختياري
النوعobject[]
تعليمات توليد لقطة تلو الأخرى، حيث يحدد كل موجّه لقطة واحدة تسهم مدتها في الطول الإجمالي للفيديو.
multi_prompt[].promptمطلوب
النوعstring
1 – 512 characters
تعليمات نصية للّقطة الحالية.
multi_prompt[].durationاختياري
النوعinteger
الافتراضي5
1 – 30
مدة اللقطة الفردية، مقاسة بالثواني.
durationاختياري
النوعinteger
الافتراضي5
3 – 30
طول الفيديو بالثواني، من 3 إلى 30.
start_image_urlاختياري image
النوعurl · image
صورة اختيارية للإطار الأول تُحتسب ضمن حد الصور المرجعية. الحد الأقصى لحجم الملف هو 30.0 MB؛ ويجب ألا يقل العرض والارتفاع عن 300 px لكل منهما، مع نسبة عرض إلى ارتفاع بين 0.40 و2.50.
image_urlsاختياري images
النوعurl[] · image
≤ 10 عناصر
صور مرجعية يُشار إليها باستخدام @Image1 و@Image2 وما إلى ذلك، بحد أقصى 10 صور. يقتصر حجم كل ملف على 30.0 MB، ويجب أن يبلغ كل بُعد 300 px على الأقل، وأن تتراوح نسبة العرض إلى الارتفاع بين 0.40 و2.50.
video_urlsاختياري videos
النوعurl[] · video
≤ 5 عناصر
ما يصل إلى 5 فيديوهات مرجعية، يُشار إليها باستخدام @Video1 و@Video2 وما إلى ذلك؛ تستمر مدة كل منها 3–30 ثانية (30.05 ثانية كحد أقصى)، ولا يمكن أن تتجاوز مدتها الإجمالية مع فيديوهات العناصر 30 ثانية. يجب ألا يتجاوز حجم كل ملف 300 MB، وأن يتراوح العرض والارتفاع بين 700 px و4553 px لكل منهما. يجب أن تتراوح نسبة العرض إلى الارتفاع بين 0.40 و2.50، ومعدل الإطارات بين 23.9 و60.05 FPS.
elementsاختياري
النوعobject[]
≤ 7 عناصر
مجموعة تضم ما يصل إلى 7 شخصيات أو كائنات، ويمكن أن يتضمن 3 منها على الأكثر `voice_id`، وأن يستخدم 3 منها على الأكثر فيديو. أشر إلى هذه العناصر باستخدام @Element1 و@Element2 وما إلى ذلك.
elements[].frontal_image_urlاختياري
النوعurl · image
صورة أمامية تعرض العرض الرئيسي للعنصر. الحد الأقصى لحجم الملف هو 30.0 MB؛ ويجب ألا يقل كلا البُعدين عن 300 px، وأن تتراوح نسبة العرض إلى الارتفاع بين 0.40 و2.50.
elements[].reference_image_urlsاختياري
النوعurl[] · image
≤ 3 items
صور تكميلية تعرض زوايا مختلفة للعنصر، من 1 إلى 3 مشاهد. يمكن ألا يتجاوز حجم كل ملف 30.0 MB، ويجب أن يبلغ كل بُعد 300 px على الأقل، وأن تتراوح نسبة العرض إلى الارتفاع بين 0.40 و2.50.
elements[].video_urlاختياري
النوعurl · video
تمثيل فيديو لعنصر بدلًا من الصور، بمدة 3–30 ثانية (30.05 ثانية كحد أقصى). يجب ألا يتجاوز حجم الملف 300 MB؛ ويجب أن يتراوح العرض والارتفاع بين 700–4553 px. تتراوح نسب العرض إلى الارتفاع المدعومة بين 0.40 و2.50، ومعدلات الإطارات بين 23.9 و60.05 FPS.
elements[].voice_idاختياري
النوعstring | null
الصوت المعيّن للعنصر.
resolutionاختياري
النوعenum
الافتراضي1080p
720p1080p
دقة المخرج.
aspect_ratioاختياري
النوعenum
الافتراضي16:9
auto16:99:161:121:9
أبعاد الفيديو، تُحدد صراحةً أو تُستنتج من المراجع عبر اختيار 'auto'.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "kling/v4/reference-to-video",
  "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": 1175,
    "usd": "1.175",
    "charged": 1175,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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/v4/reference-to-video.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt