TokenLab تضيف مراجع عناصر Kling 3.0 لسير عمل Video API

يتطلب العرض التوضيحي للمنتج الذي يضم حذاءً ويداً مرجعين بصريين، وليس واحداً فقط. نحن ندعم الآن مراجع عناصر Kling 3.0 في واجهة برمجة تطبيقات (API) توليد الفيديو. تتيح واجهة برمجة تطبيقات مراجع عناصر Kling 3.0 للمطورين تثبيت منتجات أو دعائم أو شخصيات محددة بعلامات مسماة (@name) تظل متسقة طوال المقطع المُنشأ. وهذا يسد فجوة في سير عمل الفيديو المعتمد على الصور، حيث لم تكن صورة مرجعية واحدة كافية للحفاظ على استقرار عناصر متعددة بصرياً عبر الإطارات.

لماذا تحتاج الفيديوهات متعددة العناصر إلى مراجع عناصر؟

تعمل الصورة المرجعية الواحدة لعنصر واحد، لكنها تفشل عندما يحتاج المشهد إلى بقاء عناصر متميزة متعددة. على سبيل المثال، يحتاج المنتج الذي تمسكه يد إلى بقاء كل من المنتج واليد مستقرين. كما تحتاج شخصيتان تتبادلان الحوار إلى استمرارية منفصلة للوجه والملابس. نحن ندعم الآن مراجع عناصر Kling 3.0 لمعالجة هذه الفجوة.

أبرز النقاط

• تتيح لك مراجع عناصر Kling 3.0 تحديد عناصر مسماة باستخدام روابط صور مرجعية، ثم استدعاؤها عن طريق العلامة (@productA، @character1) مباشرة في نص المطالبة (prompt) الخاص بك.
• يهدف هذا إلى المشاهد متعددة العناصر: منتج بالإضافة إلى نموذج يد، شخصية بالإضافة إلى دعامة، شخصيتان في لقطة حوار، وإعدادات مشابهة حيث كانت صورة مرجعية واحدة لكل طلب تمثل قيداً في السابق.
• لا تقم بدمج kling_elements مع output_audio=true في نفس الطلب. فالمعاملان متنافيان وفقاً لعقد واجهة برمجة التطبيقات الحالي.
• تتواجد مراجع العناصر جنباً إلى جنب مع دعم TokenLab الحالي للمراجع في الفيديو للنماذج الأخرى. وهي تمنح المطورين نمطاً متسقاً لاختيار النهج الصحيح لكل حالة استخدام.

كيف تعمل واجهة برمجة تطبيقات مراجع عناصر Kling 3.0

تعامل معظم عمليات توليد الفيديو المعتمدة على الصور الصورة المرجعية كمرساة واحدة. أنت تعطي النموذج صورة، ويحاول الحفاظ على المظهر العام متسقاً أثناء تحريك الحركة حولها. يعمل هذا مع اللقطات ذات العنصر الواحد، لكنه ينهار بسرعة عندما يحتاج المشهد إلى أكثر من عنصر متميز بصرياً للبقاء بشكل مستقل.

تحل مراجع عناصر Kling 3.0 هذه المشكلة من خلال السماح لك بتسجيل صور مرجعية متعددة مسماة في طلب واحد. ثم تقوم بالإشارة إليها بشكل فردي من داخل نص المطالبة. بدلاً من مرجع ضمني واحد، تحصل على مراجع صريحة وقابلة للعنونة. يعرف النموذج أن @shoe تشير إلى الصورة المرجعية الأولى وأن @model تشير إلى الصورة المرجعية الثانية. ويقوم بتركيب المشهد باستخدام كلتا المرساة في وقت واحد.

لقد رأينا هذا النمط في عقد واجهة برمجة التطبيقات الحالي. إنها خطوة مهمة للأمام في التحكم في خطوط إنتاج فيديوهات المنتجات، وأدوات المحتوى القائم على الشخصيات، ومولدات الإعلانات الإبداعية. غالباً ما يكون اتساق الموضوع عبر المقطع هو الفرق بين مخرجات قابلة للاستخدام وإعادة التصوير.

استخدام واجهة برمجة تطبيقات مراجع عناصر Kling 3.0 في الطلبات

النمط مباشر: حدد عناصرك، وقم بتسميتها، وأشر إليها في المطالبة باستخدام صيغة @.

{
  "model": "kling-3.0",
  "prompt": "@shoe rotates slowly on a marble pedestal while @hand reaches in to pick it up",
  "kling_elements": [
    {
      "name": "shoe",
      "image_url": "https://example.com/product-shoe.png"
    },
    {
      "name": "hand",
      "image_url": "https://example.com/hand-reference.png"
    }
  ],
  "duration": 5,
  "aspect_ratio": "16:9"
}

بعض الملاحظات العملية للتنفيذ:

• يجب أن تكون أسماء العناصر قصيرة وغير غامضة. تجنب الأسماء التي تتداخل مع الكلمات الإنجليزية الشائعة التي من المحتمل أن تظهر بالفعل في نص مطالبتك. هذا التداخل يزيد من فرصة غموض التحليل.
• يجب أن تكون روابط الصور المرجعية قابلة للوصول للجمهور في وقت الطلب. إذا كانت صورك خلف طبقة تخزين محمية، فقم بإنشاء رابط موقع أو عام قبل إرسال الطلب.
• يمكنك دمج عناصر متعددة في مطالبة واحدة، ولكن حافظ على تركيز وصف المشهد الإجمالي. فتكديس أكثر من عنصرين أو ثلاثة عناصر مسماة يميل إلى إضعاف قدرة النموذج على تتبع كل منها بشكل متميز. هذا مشابه لكيفية تقليل كثرة الموضوعات المسماة في مطالبة صورة ثابتة من دقة كل موضوع.
• اختبر بمدة قصيرة أولاً. تظهر مشكلات اتساق العناصر، في حال حدوثها، في الثواني القليلة الأولى. من الأرخص اكتشافها في مسودة مدتها 3 ثوانٍ بدلاً من عرض كامل مدته 10 ثوانٍ.

قائمة التحقق من التنفيذ

قبل إطلاق سير عمل مراجع عناصر Kling 3.0 للإنتاج، تأكد مما يلي:

• كل عنصر له اسم فريد وغير غامض
• روابط الصور المرجعية قابلة للوصول للجمهور ومستقرة طوال فترة المعالجة
• نص المطالبة يضع علامة صحيحة على كل عنصر باستخدام صيغة @name
• لم يتم ضبط output_audio على true عند وجود kling_elements
• يتحقق التحقق من الطلب من تعارض الصوت والعناصر قبل وصوله إلى واجهة برمجة التطبيقات
• تستخدم عمليات العرض الاختبارية مدداً قصيرة قبل الالتزام بالتوليد الكامل
• يظل إجمالي العناصر المسماة لكل طلب عند اثنين أو ثلاثة للحصول على أفضل اتساق

القاعدة الواحدة: لا عناصر مع صوت

من السهل تفويت هذا القيد أثناء النماذج الأولية السريعة: لا يمكن استخدام kling_elements و output_audio=true في نفس الطلب. إذا قمت بإرسال كليهما، فلن تتم معالجة الطلب كما هو متوقع.

إذا كان سير عملك يحتاج إلى كل من الاتساق البصري متعدد العناصر والصوت المُنشأ، فقم بتقسيم العمل إلى خطوتين. قم بتوليد الفيديو مع مراجع العناصر أولاً. ثم قم بتشغيل تمريرة توليد الصوت بشكل منفصل واجمع المخرجات لاحقاً. هذا قيد موثق لتكامل Kling 3.0 الحالي، وليس خطأ برمجياً. قم ببناء منطق التحقق من الطلب الخاص بك حوله بدلاً من التعامل معه كحالة استثنائية لاكتشافها بعد فوات الأوان.

في خط أنابيبنا، نتحقق من هذا التعارض من جانب العميل قبل إرسال الطلب.

مقارنة واجهة برمجة تطبيقات مراجع عناصر Kling 3.0 بسير عمل الفيديو الأخرى

تعد مراجع العناصر أداة واحدة في مجموعة متنامية من قدرات المرجع إلى الفيديو المتاحة من خلال واجهة برمجة تطبيقات الفيديو الخاصة بـ TokenLab. من المفيد معرفة متى تستخدم ماذا:

سير العمل	الأفضل لـ	عدد المراجع	ملاحظات
من صورة إلى فيديو (فردي)	تحريك بسيط لصورة ثابتة واحدة	1	يعمل عبر معظم نماذج الفيديو المدعومة، بما في ذلك Seedance و PixVerse V6
مراجع عناصر Kling 3.0	مشاهد متعددة العناصر تحتاج إلى اتساق مستقل	2-3 عناصر مسماة	لا يوجد صوت في نفس الطلب
مرجع النمط أو الحركة	تطبيق نمط بصري أو نمط حركة الكاميرا	1 مرجع نمط + مطالبة	متاح في نماذج مختارة، تحقق من وثائق كل نموذج
المطالبة النصية فقط	تكرار سريع، لا حاجة لمرساة بصرية	0	الأسرع في النماذج الأولية، الأقل قابلية للتحكم

إذا كنت تبني مولداً لعروض المنتجات التوضيحية، فإن مراجع العناصر هي الخيار الصحيح عادةً. إذا كنت تقوم بتحريك بسيط لصورة رئيسية واحدة، فإن التحويل من صورة إلى فيديو عادي أسرع وأرخص في التكرار. يمكن للفرق التي تقارن نماذج الفيديو بشكل أوسع البدء بـ أفضل نماذج فيديو AI لاستخدام واجهة برمجة التطبيقات في 2026. فهو يغطي كيفية مقارنة Kling 3.0 بـ Veo 3 وخيارات أخرى لحالات استخدام مختلفة.

الأسئلة الشائعة

هل يمكنني استخدام أكثر من مرجعين للعناصر في طلب Kling 3.0 واحد؟

نعم، لا تضع واجهة برمجة التطبيقات حداً أقصى للعدد، ولكن الاتساق العملي يميل إلى التدهور كلما أضفت المزيد من العناصر المسماة إلى مشهد واحد. اثنان إلى ثلاثة هو حد عمل معقول لمعظم حالات استخدام المنتجات والشخصيات.

ماذا يحدث إذا أرسلت كلاً من kling_elements و output_audio=true؟

لن تتم معالجة الطلب بشكل صحيح لأن هذين المعاملين متنافيان في تكامل Kling 3.0 الحالي. تحقق من هذا المزيج من جانب العميل قبل إرسال الطلب لتجنب المكالمات المهدرة.

هل دعم مراجع العناصر خاص بـ Kling 3.0، أم متاح في نماذج أخرى أيضاً؟

مراجع العناصر المسماة باستخدام وسم @name خاصة بـ Kling 3.0 في واجهة برمجة التطبيقات الحالية. نماذج الفيديو الأخرى المدعومة لها أنماط مرجع إلى فيديو خاصة بها. وعادة ما تقتصر على صورة مرجعية واحدة لكل طلب، لذا تحقق من وثائق النموذج المحددة قبل افتراض تكافؤ الميزات.

المصادر، الحداثة، والقراءة ذات الصلة

تعكس هذه المقالة وثائق واجهة برمجة تطبيقات الفيديو الخاصة بـ TokenLab وسلوك تكامل Kling 3.0 الملاحظ في 2026-07-07. للحصول على مرجع المعاملات الحالي، راجع مرجع واجهة برمجة تطبيقات إنشاء الفيديو و دليل توليد الفيديو. يمكن أن يتغير سلوك واجهة برمجة التطبيقات، لذا تحقق دائماً من الوثائق الحية قبل إنهاء تكامل الإنتاج.

توسع مراجع العناصر ما هو ممكن مع Kling 3.0، ولكن اختيار نموذج الفيديو الصحيح وفهم التكاليف لا يزال مهماً قبل بناء سير عمل إنتاجي. إذا كنت تقارن الخيارات، فإن دليل أفضل واجهات برمجة تطبيقات نماذج الفيديو AI: كيف يجب على المطورين اختيار نماذج توليد الفيديو يستعرض المقايضات عبر المزودين. لإلقاء نظرة فاحصة على Kling تحديداً، يحلل دليل تسعير واجهة برمجة تطبيقات Kling AI: التكلفة، سير العمل، والبدائل اعتبارات التسعير وسير العمل. وإذا كنت تزن البدائل، فإن دليل واجهة برمجة تطبيقات Seedance: متى تستخدمه لتوليد فيديو AI يغطي متى يكون هذا النموذج أكثر ملاءمة.

تتغير قدرات النماذج والأسعار بشكل متكرر، لذا تحقق من إصدارات النماذج الحالية والأسعار مباشرة قبل الاعتماد عليها للاستخدام الإنتاجي عالي الحجم. يشرح مرجع إعداد الحساب إنشاء مفتاح واجهة برمجة التطبيقات.

لبدء بناء سير عمل فيديو متعدد العناصر، احصل على مفتاح واجهة برمجة تطبيقات TokenLab الخاص بك وتحقق من دليل توليد الفيديو.