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

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
**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...

**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...

**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...

Уютная база отдыха с деревянными домиками-шале среди сосен. Майя и Клиентка заходят в теплое кафе... فيديو

Уютная база отдыха с деревянными домиками-шале среди сосен. Майя и Клиентка заходят в теплое кафе с панорамными окнами. Внутри деревянный интерьер, мягкие диваны и живые цветы. Они садятся за столик, перед ними стоят дымящиеся чашки чая. Мягкий свет ламп создает уют. Средний план, уровень глаз. (...

**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...

Реалистично оживи старую семейную фотографию. Все люди сохраняют свои оригинальные лица, черты вн... فيديو

Реалистично оживи старую семейную фотографию. Все люди сохраняют свои оригинальные лица, черты внешности, возраст, причёски и одежду. Мужчины слегка поворачивают головы, естественно моргают и едва заметно улыбаются. Женщина слева спокойно смотрит в камеру и мягко моргает. Маленький ребёнок слегка...

Create a realistic 30-second vertical 9:16 video showing two construction workers installing larg... فيديو

Create a realistic 30-second vertical 9:16 video showing two construction workers installing large white patio tiles in a modern backyard. Show the entire construction process in a smooth timelapse. Gradually transform the unfinished backyard into a luxurious outdoor living space with an L-shaped...

Create a warm, emotional 8–10 second cinematic video showing the difference between a young child... فيديو

Create a warm, emotional 8–10 second cinematic video showing the difference between a young child playing alone and playing with their mother. Scene 1: A toddler sits on the floor playing with toys independently. The child is calm and focused, exploring and learning through independent play. The...

إنشاء طلب

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

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