curl-X POST 'https://pollo.ai/api/platform/v1/generation/kling-ai/kling-v1/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", "aspectRatio": "16:9", "duration": 5, "mode": "std" }}'
{"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","aspectRatio":"16:9","duration":5,"mode":"std"},"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.
aspectRatio
string
不
Output aspect ratio, as width:height (e.g. 16:9).
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).
ما يميز برنامج Kling 1.0 هو إمكانية التحكم في حركة الكاميرا. يمكنك التحكم في حركات الكاميرا الأفقية والرأسية والدورانية والتكبير والتصغير، بالإضافة إلى الحركات المُعدّة مسبقًا، لتوجيه مسار اللقطة بدلاً من ترك الحركة للصدفة.
باستخدام Kling 1.0 على Pollo API، يضيف المطورون ميزة تحويل النص إلى فيديو والصورة إلى فيديو إلى Apps، ويختارون مقاطع مدتها 5 أو 10 ثوانٍ، والوضع القياسي أو pro ، ويضبطون قوة المطالبات لكل طلب.
الميزات الرئيسية لواجهة برمجة تطبيقات Kling 1.0
التحكم في اتجاه الكاميرا
يمكن للقطات أن تتحرك أفقيًا وعموديًا، أو تميل، أو تدور، أو تقرب، أو تتبع الحركة أفقيًا وعموديًا، وتتيح لك الحركات المسبقة مثل الحركة للأمام لأعلى تكوين حركة متعمدة بدلاً من قبول الانحراف الافتراضي.
إرشادات الإطار الأول والأخير
قم بتغذية صورة البداية وصورة النهاية، وسيقوم Kling 1.0 بربط الاثنين، مما يمنحك التحكم في مكان فتح المقطع ومكان حله.
نقاط بداية النص والصورة
ابدأ من موجه مكتوب أو قم بتحريك صورة ثابتة موجودة، بحيث يخدم النموذج نفسه كلاً من النصوص التي تعتمد على الفكرة أولاً وسير العمل الذي يعتمد على الأصول أولاً دون الحاجة إلى تبديل الأدوات.
قوة التنبيه القابلة للتعديل
يتحكم عنصر التحكم في القوة في مدى دقة تتبع الإخراج لرسالتك مقابل الصورة الأصلية، مما يسمح لك بالاختيار بين الحركة الدقيقة والنتائج الأكثر مرونة وإبداعًا.
أوضاع الجودة
تُضحي أوضاع Standard و Pro و 4K بالسرعة من أجل الدقة، بحيث يمكنك التكرار بسرعة على المسودات ثم إعادة تشغيل لقطة مختارة بتفاصيل أعلى.
حالات استخدام واجهة برمجة تطبيقات Kling 1.0
اللقطات الموجهة بالكاميرا: قم ببرمجة تكبير بطيء أو إمالة متدحرجة في المشهد، وهو أمر مفيد للأدوات التي يرغب المستخدمون فيها بالتحكم في العدسة، وليس فقط في الموضوع.
مقاطع بداية ونهاية: قم بتعيين صورة ثابتة افتتاحية وصورة ثابتة ختامية بحيث يقع الانتقال أو الكشف بالضبط على الإطار النهائي الذي اخترته.
تحريك الصور الثابتة: قم بتحويل صورة المنتج أو الرسم التوضيحي أو الصورة الشخصية إلى لقطة متحركة قصيرة مع الحفاظ على الإطار الأصلي سليمًا.
النمذجة الأولية للفيديو من خلال الرسائل النصية: قم بإنشاء مسودات سريعة تعتمد على النصوص لمعاينة فكرة ما قبل تخصيص الوقت لنسخة ذات دقة أعلى.
نشر بنسبة العرض إلى الارتفاع: قم بإنتاج مقاطع بنسبة 16:9 أو 9:16 أو 1:1 بحيث يغذي التكامل الواحد مشغلات العرض الأفقية والموجزات الرأسية والمواضع المربعة.
حلقات المسودة المتكررة: استخدم الوضع القياسي لإعادة التشغيل السريع، ثم قم بتبديل اللقطة المفضلة إلى pro أو 4K للتصدير النهائي.
التنظيف الموجه بالسلب: توجيه الإخراج بعيدًا عن العناصر أو القطع الأثرية غير المرغوب فيها باستخدام المطالبات السلبية للحفاظ على المشاهد موجزة.
كيفية استخدام واجهة برمجة تطبيقات Kling 1.0
الحصول على مفتاح API: قم بإنشاء حساب Pollo API وقم بإنشاء مفتاح API الخاص بك من لوحة تحكم المطور.
اختر النموذج: أرسل الطلبات إلى نقطة نهاية Kling 1.0 على /generation/kling-ai/kling-v1.
أضف مدخلاتك: بالنسبة لتحويل النص إلى فيديو، مرر prompt وaspectRatio؛ بالنسبة لتحويل الصورة إلى فيديو، مرر عنوان URL للصورة وimageTail الاختياري، ثم حدد length (5 أو 10) وmode وstrength.
إنشاء واسترجاع: قم بإرسال المهمة، واستطلاع حالة المهمة المُعادة، وتنزيل الفيديو النهائي بمجرد نجاح المعالجة.
أفضل الممارسات في توجيه المستخدمين لواجهة برمجة تطبيقات Kling 1.0
تعامل مع التوجيه كوصف للقطة. حدد الموضوع، والحركة، وحركة الكاميرا التي تريدها، لأن Kling 1.0 يستجيب بشكل جيد عندما يتم تحديد سلوك العدسة بشكل صريح.
صيغة بسيطة للاستجابة السريعة
الموضوع + الحركة + حركة الكاميرا (تحريك أفقي، إمالة، تكبير، دوران) + الإعداد والإضاءة + الأسلوب
ما يجب أن تلاحظه
استدعاء الكاميرا: حدد الحركة الدقيقة، مثل التكبير البطيء أو الإمالة لأعلى، حتى يكون لدى عنصر التحكم المدمج في الكاميرا هدف واضح.
استخدام إطارات النهاية: عندما يحتاج المقطع إلى نهاية دقيقة، قم بتوفير صورة بداية ونهاية بدلاً من وصف النهاية بالكلمات.
ضبط القوة: قم بتقليل قوة الإشارة للحفاظ على صورة المصدر بشكل أكبر، وقم برفعها لدفع الحركة والتغيير الموصوفين.
حافظ على حركة واحدة: الحركة الواضحة الواحدة تظل متماسكة بشكل أفضل على مدار 5 أو 10 ثوانٍ من عدة حركات متنافسة.
إضافة السلبيات: سرد العناصر التي يجب تجنبها حتى يبتعد النموذج عن الفوضى أو التشوه أو التفاصيل الخارجة عن نطاق المهمة.
نسبة المطابقة للمنصة: اختر 9:16 للتغذية العمودية، أو 16:9 للاعبين، أو 1:1 للتهيئة المربعة في المقدمة.
أمثلة على المطالبات
تصميم داخلي بكاميرا
"غرفة قراءة هادئة في مكتبة عند الغسق، غبار يتطاير في الضوء، مصباح واحد يتوهج على طاولة خشبية. تقريب بطيء للكاميرا نحو كتاب مفتوح، إضاءة كهرمانية دافئة، أسلوب واقعي هادئ."
انتقال مُحاط بنهاية
"طائر كركي أوريغامي مغلق على مكتب ينفتح ويتحول إلى ورقة واحدة. كاميرا علوية ثابتة، ضوء نهار ناعم، أسلوب بسيط ونظيف، يستقر على الصفحة المسطحة كإطار نهائي."
صور متحركة ثابتة
"قم بتحريك صورة واجهة المقهى هذه: بخار يتصاعد من الأكواب على الطاولات الخارجية، ومظلة مخططة ترفرف، ومارة يمرون في الخلفية. تحريك الكاميرا أفقيًا بلطف، ضوء منتصف النهار، أسلوب واقعي طبيعي."
اختبار الحركة الاتجاهية
"راكب قارب كاياك وحيد يجدف عبر بحيرة جبلية هادئة عند شروق الشمس، والضباب يغطي الماء، وخلفه تلال من أشجار الصنوبر. تميل الكاميرا لأعلى من المجداف إلى القمم، ضوء الصباح البارد، أسلوب واقعي واضح."
Kling 1.0 مقابل Runway Gen-3 Alpha مقابل Luma Dream Machine
اللقطات الموجهة بالكاميرا واللقطات ذات البداية والنهاية
تحرير باستخدام فرشاة الحركة
مسودات سريعة ومعبرة
لماذا تختار واجهة برمجة تطبيقات Kling 1.0 ؟
يناسب Kling 1.0 المنتجات التي تحتاج إلى تحكم على مستوى اللقطة، بدءًا من حركات الكاميرا الموجهة وحتى المقاطع التي تفتح وتغلق على إطارات مختارة، عبر كل من نقاط بداية النص والصورة.
من خلال Pollo API، يمكنك الوصول إلى Kling 1.0 باستخدام مفتاح API واحد إلى جانب أكثر من 300 نموذج فيديو وصور رائد، مع وثائق واضحة، واستطلاع حالة المهام، وتوليد بتكلفة أقل من Fal AI.
قم بدمج نقطة نهاية Kling 1.0 على Pollo API لتوفير ميزات الفيديو الموجهة بالكاميرا، ثم اختبرها مقابل إصدارات Kling الأحدث والنماذج المنافسة دون المساس بعملية التكامل الخاصة بك.
الأسئلة الشائعة حول واجهة برمجة تطبيقات Kling 1.0
ما هو Kling 1.0؟
Kling 1.0 هو نموذج Kling AI الأصلي للفيديو لإنشاء الفيديو من النص والصورة، ويتميز بالتحكم الاتجاهي في الكاميرا، وتوجيه إطار البداية والنهاية، وقوة التوجيه القابلة للتعديل.
هل يدعم Kling 1.0 API إدخال النصوص والصور؟
نعم. يمكنك إنشاء المحتوى من خلال إدخال نص بنسبة عرض إلى ارتفاع محددة، أو تحريك رابط صورة، ويمكنك إضافة صورة في النهاية لتشكيل النهاية.
ما هي أطوال المقاطع والأنماط المتاحة؟
يقوم Kling 1.0 بإنتاج مقاطع فيديو مدتها 5 أو 10 ثوانٍ، ويوفر أوضاعًا قياسية pro و4K حتى تتمكن من تحقيق التوازن بين سرعة الإنتاج وتفاصيل الإخراج.
كيف تعمل آلية التحكم بالكاميرا؟
يمكنك طلب حركات مثل التحريك الأفقي، والإمالة، والتدوير، والتكبير، والتتبع الأفقي أو الرأسي، بالإضافة إلى الحركات المحددة مسبقًا، مما يمنحك تحكمًا دقيقًا في كيفية انتقال كل لقطة.
ما فائدة قوة الاستجابة السريعة؟
تحدد قوة التوجيه مدى دقة تطابق النتيجة مع التوجيه الخاص بك مقابل الصورة الأصلية، مما يتيح لك الاختيار بين الحركة الدقيقة وإعادة التفسير الأكثر مرونة.
لماذا يتم تشغيل Kling 1.0 من خلال Pollo API؟
توفر واجهة برمجة تطبيقات Pollo تكاملاً واحداً لـ Kling 1.0 وأكثر من 300 نموذج آخر، مع توفير الوثائق وتتبع المهام وتوليد بتكلفة أقل من مقدمي الخدمات المماثلة.
