curl-X POST 'https://pollo.ai/api/platform/v1/generation/kling-ai/kling-v2-1/video'\-H'Content-Type: application/json'\-H'x-api-key: YOUR_API_KEY'\-d'{ "input": { "prompt": "A cinematic shot of a golden retriever running through a field of sunflowers at sunset, warm rim light, shallow depth of field", "negativePrompt": "blurry, low quality, distorted, watermark, text", "image": "https://example.com/first-frame.jpg", "duration": 5, "mode": "std", "strength": 50 }}'
يمكنك تضمين webhookUrl اختياريًا لتلقي رد اتصال عند نجاح المهمة أو فشلها.
حقل طلب اختياري
{"input":{"prompt":"A cinematic shot of a golden retriever running through a field of sunflowers at sunset, warm rim light, shallow depth of field","negativePrompt":"blurry, low quality, distorted, watermark, text","image":"https://example.com/first-frame.jpg","duration":5,"mode":"std","strength":50},"webhookUrl":"https://example.com/webhooks/pollo"}
مخطط
حقول إدخال لنقطة النهاية والوضع المحددين.
مجال
يكتب
مطلوب
وصف
prompt
string
لا
Text prompt describing the content to generate.
negativePrompt
string
لا
Text describing elements to avoid in the generated output.
image
string
نعم
First-frame / reference image URL (HTTP(S).
duration
number
لا
The duration of the generated video, in seconds.
mode
string
لا
Generation mode of the model (e.g. a faster or higher-quality tier).
strength
number
لا
Prompt adherence strength; higher values follow the prompt more strictly.
يُعدّ Kling 2.1 نموذج فيديو مُطوّر يتميّز بتحسينات في سرعة الاستجابة، وحركة أكثر ثباتًا للشخصيات، ووضوح بصري أعلى. وهو يدعم تحويل النصوص إلى فيديوهات والصور إلى فيديوهات.
من خلال واجهة برمجة تطبيقات Pollo ، يضيف المطورون ميزة تحويل النص إلى فيديو والصور إلى فيديو Kling 2.1 إلى منتجاتهم، ويختارون مخرجات قياسية أو pro أو بدقة 4K ومقاطع فيديو مدتها 5 أو 10 ثوانٍ لكل طلب.
الميزات الرئيسية لواجهة برمجة تطبيقات Kling 2.1
الالتزام التام بالمواعيد
تتطابق المواضيع والأفعال والإخراج الموصوفة بشكل وثيق مع الشاشة، لذا فإن المشهد المكتوب يترجم إلى اللقطة المقصودة بدلاً من تقريب فضفاض يحتاج إلى إعادة صياغة.
حركة شخصية أكثر ثباتًا
يتحرك الناس والكائنات بوزن واستمرارية أكثر طبيعية، مما يحافظ على تماسك الأطراف والوضعية والمشية عبر المقطع بدلاً من التشويه أثناء الحركات السريعة أو المعقدة.
التحكم في بداية ونهاية الإطار
قم بتوفير إطار أول وإطار نهاية، وسيقوم Kling 2.1 بملء الحركة بينهما، مما يمنحك تحكمًا دقيقًا في كيفية بدء اللقطة وانتهاءها.
جودة مخرجات متدرجة
اختر الوضع القياسي للمسودات السريعة، pro للحصول على تفاصيل أنظف، أو وضع 4K عندما تحتاج اللقطة إلى أن تظل واضحة على الشاشات الكبيرة، بما يتناسب مع الجهد المبذول وتنسيق العرض.
قوة التلقين والنفي
يتحكم عنصر التحكم في القوة في مدى طاعة النموذج للموجه، بينما تعمل الموجهات السلبية على إخراج العناصر غير المرغوب فيها، مما يعطي نتائج قابلة للتوجيه دون الحاجة إلى محاولات لا نهاية لها.
حالات استخدام واجهة برمجة تطبيقات Kling 2.1
انتقالات الإطارات الرئيسية: قم بتعيين صورة بداية ونهاية ودع Kling 2.1 يقوم بإنشاء الحركة الوسيطة للكشف المتحكم فيه، والتحولات، وتغييرات حالة المنتج.
مقاطع حركة الشخصية: تحريك شخصية موصوفة أثناء المشي أو الإيماء أو رد الفعل حيث تكون حركة الجسم المتسقة أكثر أهمية من المؤثرات البصرية الثقيلة.
تحريك الصور الثابتة: قم بتغذية صورة واحدة وإضفاء الحيوية عليها كلقطة متحركة قصيرة مع الحفاظ على الإطار الأصلي والموضوع سليمين.
مقاطع توضيحية قصيرة: قم بإنتاج مقاطع قصيرة جاهزة بدقة 4K للأدوات التي تحتاج إلى حركة نظيفة ودقيقة داخل البرامج التعليمية وتسلسلات كيفية الاستخدام.
التصور المسبق للمفهوم: دع الفرق الإبداعية ترى لقطة موصوفة قبل الالتزام بالإنتاج الكامل، مع الثقة في أن الناتج سيتوافق مع التوجيه المكتوب.
أتمتة الفيديو الاجتماعي: إنشاء مقاطع فيديو عمودية أو عريضة مدتها 5 أو 10 ثوانٍ بكميات كبيرة Apps المحتوى التي تقوم بتجميع العديد من المطالبات من خلال مسار واحد.
التصميم التكراري: استخدم الوضع القياسي لاختبار العديد من الاختلافات بسرعة، ثم أعد عرض الفائز بدقة pro أو بدقة 4K للأصل النهائي.
كيفية استخدام واجهة برمجة تطبيقات Kling 2.1
الحصول على مفتاح API: قم بإنشاء حساب Pollo API وقم بإنشاء مفتاحك من لوحة تحكم المطور.
اختر النموذج: أرسل الطلبات إلى نقطة نهاية Kling 2.1 على /generation/kling-ai/kling-v2-1.
أضف مدخلاتك: قم بتوفير image لتحويل الصورة إلى فيديو بالإضافة إلى prompt، ويمكنك إضافة imageTail للتحكم في الإطار النهائي، ثم قم بتعيين mode (std، pro، أو 4k) وlength (5 أو 10).
إنشاء واسترجاع: قم بإرسال المهمة، واستطلاع حالة المهمة المُعادة، وتنزيل الفيديو النهائي بمجرد نجاح المعالجة.
أفضل الممارسات في توجيه المستخدمين لواجهة برمجة تطبيقات Kling 2.1
لأن Kling 2.1 يكافئ التوجيه الدقيق، اكتب عبارات تحدد الموضوع، والفعل الدقيق، وسلوك الكاميرا، والإعداد، ثم قم بإزالة العناصر غير المرغوب فيها باستخدام عبارة سلبية.
صيغة بسيطة للاستجابة السريعة
الموضوع + الحركة المحددة والإيقاع + حركة الكاميرا + الإعداد والإضاءة + الأسلوب، مع ذكر السلبيات لأي شيء يجب استبعاده.
ما يجب أن تلاحظه
كن حرفياً بشأن الحركة: حدد بالضبط ما يتحرك وكيف، لأن النموذج يتبع الحركة الموصوفة عن كثب بدلاً من ابتكار حركته الخاصة.
استخدم المطالبات السلبية: قم بإدراج العناصر التي يجب تجنبها، مثل الأيدي الإضافية أو تراكبات النصوص، لتنظيف النتائج دون إعادة التدوير.
تخطيط الإطارات الرئيسية: عند استخدام إطارات البداية والنهاية، اجعل كلتا الصورتين تشتركان في الإضاءة والتأطير بحيث تظل الحركة الناتجة سلسة.
ضبط قوة التوجيه: ارفع القوة للالتزام الصارم، وخفّضها عندما تريد أن يتمتع النموذج بمزيد من الحرية في تفسير المشهد.
وضع المطابقة للغرض: قم بالتصميم في الوضع القياسي، ثم قم بالإنهاء في pro أو بدقة 4K بحيث تقضي وقت العرض فقط على اللقطات التي تحتفظ بها.
أمثلة على المطالبات
كشف الإطار الرئيسي
"طائر كركي أوريغامي مغلق موضوع على طاولة خشبية، ينفتح ببطء ليصبح ورقة واحدة. كاميرا علوية، ضوء نهار ناعم من نافذة قريبة، أسلوب بسيط وهادئ. إطار البداية مطوي، إطار النهاية مسطح."
حركة الشخصية
"عازفة كمان شابة ترسم ضربة قوس طويلة، ترتفع أكتافها مع اللحن، وتغمض عينيها بتركيز. حركة بطيئة للداخل، إضاءة دافئة لغرفة التدريب، أسلوب واقعي. ملاحظة سلبية: أذرع إضافية، أيادٍ ضبابية."
لقطة حرفية يومية
"يقوم صانع القهوة بسكب الحليب المبخر في الإسبريسو، فتتشكل على السطح نقوش تشبه أوراق الشجر مع امتلاء الكوب. لقطة مقرّبة من الأعلى، إضاءة مقهى ناعمة، أسلوب نظيف وواقعي، أيادٍ ثابتة وسكب سلس."
لقطات مقربة للطبيعة
"ترتجف شبكة عنكبوت مغطاة بالندى مع مرور نسيم خفيف، ترتجف القطرات لكنها تتمسك ببعضها. لقطة ماكرو، إضاءة خلفية في الصباح الباكر، تركيز ضحل، أسلوب طبيعي، حركة لطيفة ومستمرة."
Kling 2.1 ضد Runway Gen-4 ضد Luma Ray 2
القدرات
Kling 2.1
Runway Gen-4
Luma Ray 2
الالتزام الفوري
✅ اتباع حرفي قوي
✅ جيد، أكثر تفسيراً
✅ جيد
ثبات حركة الشخصية
✅ أطراف وخطوات ثابتة
✅ صلب
✅ سلس ولكن أكثر نعومة
التحكم في إطار البداية والنهاية
✅ الإطار الأول والإطار الأخير
✅ دعم الإطارات الرئيسية
✅ إطارات البداية والنهاية
خيارات الدقة
حتى 4K
حتى 1080P
حتى 1080P
مدة المقطع
5 أو 10 ثوانٍ
مقاطع قصيرة
مقاطع قصيرة
يُنصح به لـ
حركة عالية الدقة ودقيقة
لقطات مؤثرات بصرية مميزة
رسوم متحركة سريعة وسلسة للصور
لماذا تختار واجهة برمجة تطبيقات Kling 2.1؟
يناسب Kling 2.1 المنتجات التي تحتاج إلى حركة لتتوافق مع الموجز، بدءًا من انتقالات الإطارات الرئيسية وحتى مقاطع الشخصيات الثابتة، مع مخرجات قابلة للتطوير من المسودات السريعة إلى 4K.
من خلال Pollo API، يمكنك الوصول إلى Kling 2.1 بمفتاح واحد إلى جانب أكثر من 300 نموذج فيديو وصور رائد، مع وثائق واضحة واستطلاع حالة المهام.
ابدأ بنقطة نهاية Kling 2.1 على Pollo API لشحن فيديو متوافق مع التعليمات ويتم التحكم فيه بواسطة الإطارات الرئيسية، ثم قارنه مع Runway و Luma و Hailuo دون المساس بتكاملك.
الأسئلة الشائعة حول واجهة برمجة تطبيقات Kling 2.1
ما هو Kling 2.1؟
Kling 2.1 هو نموذج فيديو Kling AI مطور يركز على الالتزام الدقيق بالتعليمات، وحركة الشخصيات الأكثر ثباتًا، والصور الأكثر وضوحًا، ويدعم إنشاء الفيديو من النص ومن الصورة إلى الفيديو.
هل يدعم Kling 2.1 API إدخال الصور؟
نعم. يمكنك تحريك صورة مصدرية، وإضافة صورة ذيلية اختيارية بحيث يقوم النموذج بتوليد الحركة بين الإطارين الأول والأخير اللذين اخترتهما.
ما هي الدقة والأطوال المتاحة؟
يوفر Kling 2.1 أوضاع إخراج قياسية pro و4K، مع تحديد أطوال المقاطع من 5 أو 10 ثوانٍ لكل طلب.
كيف يتعامل مع حركة الشخصية؟
يرتكز التحديث على الاستمرارية، بحيث تظل الأطراف والوضعية والمشية متماسكة من خلال الحركات السريعة أو المعقدة بدلاً من أن تتشوه في منتصف المقطع.
هل يمكنني التحكم في مدى التزامه التام بالتعليمات؟
نعم. يعمل إعداد قوة التنبيه على ضبط الالتصاق، وتتيح لك التنبيهات السلبية استبعاد العناصر غير المرغوب فيها للحصول على نتائج أنظف وأكثر توجيهًا.
لماذا يتم تشغيل Kling 2.1 من خلال Pollo API؟
توفر واجهة برمجة تطبيقات Pollo تكاملاً واحداً لـ Kling 2.1 وأكثر من 300 نموذج آخر، مع توفير الوثائق وتتبع المهام.