Kling: Video v3.0 Pro
Kling VIDEO 3.0 Pro هو خيار الفيديو الاحترافي بدقة 1080p من Kuaishou للمشاهد الموجّهة بالنصوص والصور. يجمع مقاطع من ثلاث إلى خمس عشرة ثانية وصوتًا أصليًا وإطارات طرفية موجّهة وتوجيه لقطة واحدة أو عدة لقطات للأفكار السينمائية والإنتاجات القصيرة.
عن النموذج
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
Kling VIDEO 3.0 Pro هو النمط الاحترافي لنموذج VIDEO 3.0 من Kuaishou. ينتج وضع Pro الموثّق فيديو 1080p من متطلبات نصية أو مشهد تقوده صورة، بمقاطع من ثلاث إلى خمس عشرة ثانية. يجمع إصدار 3.0 الصوت الأصلي وإعدادات اتساق الموضوع والتوجيه متعدد اللقطات، فيمنح الإنتاج القصير طريقة واضحة لتحديد المظهر والفعل وتغطية الكاميرا والصوت.
ابدأ بالفعل الرئيسي للمشهد. وفي لقطة يقودها النص، صف الموضوع والبيئة والضوء والمنظور الذي يجعل الفعل واضحًا. وفي لقطة تقودها صورة، دع الصورة الافتتاحية تحدد المظهر والتكوين ثم استخدم النص لما يتغير مع الوقت. ولمفهوم منتج أصلي، يمكن لصورة مُعدّة عرض الشيء على سطح استوديو بينما يصف التوجيه كشفًا بطيئًا لخاماتِه وشكله.
يوفر التوجيه متعدد اللقطات تغطية تلقائية أو تسلسلًا مخصصًا. يخطط التوليد التلقائي متعدد اللقطات تغيرات التأطير وزاوية الكاميرا من المتطلبات؛ ويمكن لمشهد يناسب منظرًا متصلًا واحدًا أن يظل لقطة واحدة. تتيح لوحة قصة مخصصة تحديد محتوى كل لقطة ومدتها. يسمح نمط اللقطات المخصصة لدى الجهة المنتجة بلقطة واحدة إلى ست لقطات، وبحد أقصى 512 حرفًا لكل لقطة وحد أدنى ثانية واحدة لكل منها؛ ويجب أن يساوي مجموع مددها مدة المقطع الكلية.
لسرد قصير، صف منظرًا تأسيسيًا والفعل الرئيسي وتفصيلًا ختاميًا كلقطات منفصلة. حدّد معالجة الكاميرا وما ينبغي أن يلاحظه الجمهور في كل منها. حافظ على اتساق مظهر الموضوع المتكرر في المتطلبات مع تغيير الفعل والتغطية عن قصد. يقبل حقل التوجيه المفرد في مرجع الشركة المصنّعة حتى 2,500 حرف؛ ويستخدم التسلسل المخصص أوصافه المنفصلة لكل لقطة.
يمكن لمراجع العناصر المصوّرة دعم مشهد تقوده صورة عندما يجب أن تظل الشخصية أو المنتج أو المكان مميزًا. اختر مناظر واضحة تنقل السمات المطلوبة وسمّ كل عنصر مصوّر مرجعي باتساق. يتيح النمط الموثّق الذي تقوده صورة حتى ثلاثة عناصر مُعدّة. ركّز أدوار المراجع بدل الجمع بين مواد متعددة تمنح تعليمات متضاربة عن مظهر الموضوع.
يوفر إطارا البداية والنهاية حدودًا بصرية لانتقال مشروط بصورة. أعدّ إطارين متوافقين في الموضوع والمشهد المقصود، ثم صف كيف تصل الحركة بينهما. يستخدم إدخال الإطار المدعوم لدى الشركة المصنّعة صور JPG أوJPEG أوPNG بملفات لا تزيد عن 10 MB وأبعاد لا تقل عن 300 بكسل ونسبة عرض لصورة البداية بين 1:2.5 و2.5:1. لمهمة مضبوطة بالإطارات ولوحة قصة مخصصة معالجتا إدخال خاصتان بهما، لذا نظّم المادة للمسار المختار قبل كتابة المتطلبات الكاملة.
يمكن للصوت الأصلي الجمع بين العبارات المنطوقة والأجواء والأداء البصري. الصوت معطّل افتراضيًا في مرجع الشركة المصنّعة ويُفعّل لمشهد سمعي بصري. تشمل مواصفات لغات 3.0 الصينية والإنجليزية واليابانية والكورية والإسبانية، مع التبديل بين اللغات ومعالجات اللهجات أو اللكنات المدعومة. ويذكر دليل الشركة المصنّعة أن الحوار المدخل بلغة أخرى يُترجم إلى الإنجليزية. أسند كل عبارة إلى الشخصية المقصودة وميّز الحوار عن صوت الخلفية، لتشرح المتطلبات الصوتية من يتكلم وما يحيط بالفعل.
يمكن لمتطلبات أصلية لشخصيتين تعريف Speaker A وSpeaker B ومنح كل منهما عبارة قصيرة ووصف الرد المرئي بينهما. اجعل الحوار متناسبًا مع طول المقطع وعرّف المتحدث عند تغير المنظر. يخدم التوجيه الصوتي ومرجع الشخصية غرضين مختلفين؛ ينبغي أن تحدد المتطلبات الأداء المقصود بدل افتراض احتواء الصورة المرجعية الكلمات المطلوب نطقها.
يحسّن VIDEO 3.0 أيضًا التعامل مع الحروف المرئية في مشهد تقوده صورة. إذا كانت لافتة أو ملصق أو تعليق مهمًا، فعرّفه في المتطلبات وحافظ على مظهره المرجعي. راجع المقطع المكتمل للتحقق من التهجئة والوضوح وحركة الحروف، خصوصًا عندما تحمل رسالة منتج أو حملة. توجه ميزة الحروف في النموذج التوليد بدل أن تستبدل الفحص البصري النهائي.
نمط Pro هو 1080p؛ ونمط Standard هو 720p. وضع 4K الذي يُختار منفصلًا لدى الجهة المنتجة نمط إخراج آخر، لذا لا ينبغي اعتبار Pro مرادفًا لكل إعداد أعلى دقة. وفي التوليد النصي، تشمل اختيارات التأطير الموثّقة 16:9 و9:16 و1:1. اختر الإطار للموضع المقصود وحافظ على وضوح التكوين داخله.
يجري التوليد كمهمة تكشف نتيجتها الناجحة مادة الفيديو المكتملة ومدته الفعلية. وتقول وثائق النتائج لدى الشركة المصنّعة إن الفيديوهات المولّدة تُحذف بعد 30 يومًا، لذا احفظ المقطع المكتمل سريعًا. احتفظ بالفيديو مع متطلباته ومواده المرجعية، ثم راجع استمرارية الموضوع وترتيب اللقطات المطلوب وحركة الكاميرا والحوار والحروف. استخدم المقطع المختار مفهومًا سينمائيًا أو مشهد منتج أو سردًا قصيرًا، وأجرِ مراجعة محددة للجزء الذي لم يحقق النتيجة المقصودة.
Ailoot Ultra · فيديو POST /v1/videos kwaivgi/kling-v3.0-pro
kwaivgi/kling-v3.0-proالبداية
Kling VIDEO 3.0 Pro هو خيار الفيديو الاحترافي بدقة 1080p من Kuaishou للمشاهد الموجّهة بالنصوص والصور. يجمع مقاطع من ثلاث إلى خمس عشرة ثانية وصوتًا أصليًا وإطارات طرفية موجّهة وتوجيه لقطة واحدة أو عدة لقطات للأفكار السينمائية والإنتاجات القصيرة.
- المدخلات المقبولة
- النص · الصور
- النتائج
- فيديو
متاح في Ailoot · المدخلات والطرائق
Ailoot Ultra · فيديو POST /v1/videos
- الإدخال
text,image- الإخراج
video- صيغة الإخراج
- بايتات MP4 الأصلية؛ دون تطبيع أو إعادة ترميز
| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود kwaivgi/kling-v3.0-pro | القيمة الافتراضية— |
الحقلprompt | النوعstring | المتطلبمطلوب | القيم والحدود | القيمة الافتراضية— |
الحقلduration | النوعinteger | المتطلبمطلوب | القيم والحدود 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 الحد الأدنى: 1 الحد الأقصى: 600 | القيمة الافتراضية— |
الحقلresolution | النوعstring | المتطلباختياري | القيم والحدود 720p | القيمة الافتراضية— |
الحقلaspect_ratio | النوعstring | المتطلباختياري | القيم والحدود 16:9, 9:16, 1:1 | القيمة الافتراضية— |
الحقلgenerate_audio | النوعboolean | المتطلباختياري | القيم والحدود false, true الشروط: يؤدي حذف هذا الخيار إلى اختيار السعر الذي يتضمن الصوت. اضبطه على false لاختيار السعر دون صوت. افحص has_audio في النتيجة لمعرفة ما إذا أُعيد مسار صوتي. | القيمة الافتراضية— |
الحقلframe_images | النوعarray | المتطلباختياري | القيم والحدود الحد الأدنى للعناصر: 1 الحد الأقصى للعناصر: 2 محتوى الإدخال: مصفوفة من كائنات الإطارات. يحتوي كل كائن على type=image_url وimage_url الذي يحتوي على url، وعلى frame_type. استخدم عنوان URL لصورة عبر HTTPS واضبط frame_type على first_frame أو last_frame. لا يتكرر كل دور إطار أكثر من مرة. المفاتيح الدقيقة: type, image_url, frame_type الشروط: تصف هذه المفاتيح كل كائن إطار؛ ولا يحتوي image_url إلا على url. احذف frame_images في الطلبات النصية فقط. | القيمة الافتراضية— |
الحقلinput_references | النوعarray | المتطلباختياري | القيم والحدود | القيمة الافتراضية— |
الحقلsize | النوعstring | المتطلباختياري | القيم والحدود 1280x720, 720x1280, 720x720 النمط: ^[1-9][0-9]*x[1-9][0-9]*$ | القيمة الافتراضية— |
الحقلcallback_url | النوعstring | المتطلباختياري | القيم والحدود النمط: ^https:// | القيمة الافتراضية— |
الحقلsession_id | النوعstring | المتطلباختياري | القيم والحدود | القيمة الافتراضية— |
الحقلtrace | النوعobject | المتطلباختياري | القيم والحدود | القيمة الافتراضية— |
الحقلuser | النوعstring | المتطلباختياري | القيم والحدود | القيمة الافتراضية— |
تركيبات مواد الإدخال
تحويل النص إلى فيديو · موجّه نصي. · مطلوب: model, prompt, duration
قدّم prompt كنص وduration بعدد صحيح من الثواني. اختر دقة مدعومة؛ وأضف نسبة أبعاد أو استخدم مقاساً مدرجاً.
model: النوع: string · kwaivgi/kling-v3.0-pro
prompt: النوع: string · الحد الأقصى لبايتات UTF-8: 10,000 · يجب أن يتضمن الإدخال محارف غير المسافات البيضاء: نعم
تحويل الصورة إلى فيديو · موجّه نصي وصورة للإطار الأول. · مطلوب: model, prompt, duration, frame_images
الحقل frame_images مصفوفة. يحتوي كل كائن إطار على type وimage_url وframe_type؛ ويحتوي image_url على url. اضبط type على image_url. استخدم first_frame مع last_frame اختياري. لا يتكرر كل دور إطار أكثر من مرة. وفّر عنوان URL عاماً لصورة عبر HTTPS لكل إطار. اختر دقة مدعومة؛ وأضف نسبة أبعاد أو استخدم مقاساً مدرجاً.
المفاتيح الدقيقة: type, image_url, frame_type
model: النوع: string · kwaivgi/kling-v3.0-pro
prompt: النوع: string · الحد الأقصى لبايتات UTF-8: 10,000 · يجب أن يتضمن الإدخال محارف غير المسافات البيضاء: نعم
معلمات الطريقة ودورة حياتها
| المعلمة | المواصفات |
|---|---|
المعلمةcontent_type | المواصفاتapplication/json |
المعلمةrequired | المواصفاتmodel, prompt, duration |
المعلمةmaterial_types | المواصفاتtext, image |
المعلمةadditional_properties | المواصفاتfalse |
المعلمةoptional_controls | المواصفاتresolution, aspect_ratio, generate_audio, frame_images, input_references, size, callback_url, session_id, trace, user |
دورة الحياة: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
الباقات
كيفية احتساب الرسوم النهائية
تقدّر التعرفات المعروضة التكلفة قبل التوليد. تُحسب الرسوم النهائية من التكلفة المسجّلة لعملية التوليد الأصلية. مدة المخرجات المقاسة والكميات المتوقعة ليست الكمية النهائية الخاضعة للفوترة.
مراجع التسعير لا تضيف خيارات للطلب. المعلمات المدعومة مذكورة للطريقة المحددة.
- الوضع السريع
- غير محدد عند اختيار الوضع السريع
- الوضع المرن
- غير محدد عند اختيار وضع flex
- أقصى جهد للاستدلال
- غير محدد عندما يُطبَّق الضبط الافتراضي default مع أقصى جهد للاستدلال
تعرفات تقديرية للمقارنة
الأسعار حسب الإعدادات
طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة.
| الإعدادات | جدول التعرفة | الكمية المتوقعة | مكوّن الرسوم | دقة المرجع | وضع المرجع | الصوت المرجعي | وحدة الفوترة | شروط الفوترة | الرسوم |
|---|---|---|---|---|---|---|---|---|---|
| الإعداداتالتعرفات الأساسية للرموز | جدول التعرفةالتعرفة الأساسية | الكمية المتوقعة— | مكوّن الرسوم— | دقة المرجع— | وضع المرجع— | الصوت المرجعي— | وحدة الفوترة— | شروط الفوترة— | الرسوم الإدخال · رموز الإدخال · تقدير للمقارنة فقط — / 1K من الرموز الإخراج · رموز الإخراج · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة · تقدير للمقارنة فقط — / 1K من الرموز |
| الإعداداتمخرجات الفيديو · السعر المرجعي | جدول التعرفة— | الكمية المتوقعة— | مكوّن الرسومreference_output_rate | دقة المرجع— | وضع المرجع— | الصوت المرجعي— | وحدة الفوترةلكل ثانية إخراج | شروط الفوترة— | الرسوم الإخراج · التعرفة المرجعية لثانية من الفيديو الناتج · تقدير للمقارنة فقط $0.224 لكل ثانية إخراج |
| الإعداداتسعر الفيديو | جدول التعرفة— | الكمية المتوقعة— | مكوّن الرسوم— | دقة المرجع— | وضع المرجع— | الصوت المرجعي— | وحدة الفوترةلكل ثانية فيديو | شروط الفوترةالصوت: with_audio | الرسوم الإخراج · سعر الفيديو · تقدير للمقارنة فقط $0.336 لكل ثانية فيديو |
| الإعداداتتحويل الصورة إلى فيديو (صور الإطارات) · 1080p · السعر المرجعي | جدول التعرفة— | الكمية المتوقعة— | مكوّن الرسومreference_output_rate | دقة المرجع1080p | وضع المرجعتحويل الصور إلى فيديو (صور الإطارات) | الصوت المرجعيمن دون صوت | وحدة الفوترةلكل ثانية إخراج | شروط الفوترة— | الرسوم الإخراج · التعرفة المرجعية لثانية من الفيديو الناتج · تقدير للمقارنة فقط $0.224 لكل ثانية إخراج |
| الإعداداتسعر الفيديو | جدول التعرفة— | الكمية المتوقعة— | مكوّن الرسوم— | دقة المرجع— | وضع المرجع— | الصوت المرجعي— | وحدة الفوترةلكل ثانية فيديو | شروط الفوترةنمط التوليد: image_to_video؛ الدقة: 720p | الرسوم الإخراج · سعر الفيديو · تقدير للمقارنة فقط $0.224 لكل ثانية فيديو |
| الإعداداتتحويل النص إلى فيديو · 1080p · السعر المرجعي | جدول التعرفة— | الكمية المتوقعة— | مكوّن الرسومreference_output_rate | دقة المرجع1080p | وضع المرجعتحويل النص إلى فيديو | الصوت المرجعيمن دون صوت | وحدة الفوترةلكل ثانية إخراج | شروط الفوترة— | الرسوم الإخراج · التعرفة المرجعية لثانية من الفيديو الناتج · تقدير للمقارنة فقط $0.224 لكل ثانية إخراج |
| الإعداداتتحويل النص إلى فيديو · 480p · السعر المرجعي | جدول التعرفة— | الكمية المتوقعة— | مكوّن الرسومreference_output_rate | دقة المرجع480p | وضع المرجعتحويل النص إلى فيديو | الصوت المرجعيمن دون صوت | وحدة الفوترةلكل ثانية إخراج | شروط الفوترة— | الرسوم الإخراج · التعرفة المرجعية لثانية من الفيديو الناتج · تقدير للمقارنة فقط $0.224 لكل ثانية إخراج |
| الإعداداتسعر الفيديو | جدول التعرفة— | الكمية المتوقعة— | مكوّن الرسوم— | دقة المرجع— | وضع المرجع— | الصوت المرجعي— | وحدة الفوترةلكل ثانية فيديو | شروط الفوترةنمط التوليد: text_to_video؛ الدقة: 720p | الرسوم الإخراج · سعر الفيديو · تقدير للمقارنة فقط $0.224 لكل ثانية فيديو |
| الإعداداتتكلفة التوليد التقديرية | جدول التعرفة— | الكمية المتوقعةتقدير لتوليد واحد | مكوّن الرسوم— | دقة المرجع— | وضع المرجع— | الصوت المرجعي— | وحدة الفوترة— | شروط الفوترة— | الرسوم الإخراج · تكلفة التوليد التقديرية · تقدير للمقارنة فقط $0.672 تقدير قبل الإنشاء هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة. |
تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →
تفاصيل التعرفة المرجعية
لا تغيّر جداول التعرفة المرجعية على مستوى النموذج اختيار الطريقة أو عروض الأسعار أو الرسوم. وتستخدم الرسوم الفعلية تعرفات طريقة Ailoot المحددة.
مراجع أسعار إعدادات الفيديو
الأسعار حسب الإعدادات
طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة.
| الإعدادات | شروط الفوترة | الرسوم |
|---|---|---|
| الإعداداتسعر الفيديو | شروط الفوترةلم يُذكر شرط إضافي في مفتاح التسعير هذا. | الرسوم الإخراج · سعر الفيديو $0.224 لكل ثانية فيديو مرجع السعر المنشور للإعداد المعروض. تتبع الرسوم النهائية الإعداد الفعلي الذي تمت فوترته. |
| الإعداداتسعر الفيديو | شروط الفوترةالصوت: with_audio | الرسوم الإخراج · سعر الفيديو $0.336 لكل ثانية فيديو مرجع السعر المنشور للإعداد المعروض. تتبع الرسوم النهائية الإعداد الفعلي الذي تمت فوترته. |
| الإعداداتسعر الفيديو | شروط الفوترةنمط التوليد: text_to_video؛ الدقة: 480p | الرسوم الإخراج · سعر الفيديو $0.224 لكل ثانية فيديو مرجع السعر المنشور للإعداد المعروض. تتبع الرسوم النهائية الإعداد الفعلي الذي تمت فوترته. |
| الإعداداتسعر الفيديو | شروط الفوترةنمط التوليد: text_to_video؛ الدقة: 720p | الرسوم الإخراج · سعر الفيديو $0.224 لكل ثانية فيديو مرجع السعر المنشور للإعداد المعروض. تتبع الرسوم النهائية الإعداد الفعلي الذي تمت فوترته. |
| الإعداداتسعر الفيديو | شروط الفوترةنمط التوليد: image_to_video؛ الدقة: 720p | الرسوم الإخراج · سعر الفيديو $0.224 لكل ثانية فيديو مرجع السعر المنشور للإعداد المعروض. تتبع الرسوم النهائية الإعداد الفعلي الذي تمت فوترته. |
| الإعداداتسعر الفيديو | شروط الفوترةنمط التوليد: text_to_video؛ الدقة: 1080p | الرسوم الإخراج · سعر الفيديو $0.224 لكل ثانية فيديو مرجع السعر المنشور للإعداد المعروض. تتبع الرسوم النهائية الإعداد الفعلي الذي تمت فوترته. |
| الإعداداتسعر الفيديو | شروط الفوترةنمط التوليد: image_to_video؛ الدقة: 1080p | الرسوم الإخراج · سعر الفيديو $0.224 لكل ثانية فيديو مرجع السعر المنشور للإعداد المعروض. تتبع الرسوم النهائية الإعداد الفعلي الذي تمت فوترته. |
أمثلة للطلبات
Ailoot Ultra · فيديو
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"kwaivgi/kling-v3.0-pro","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
استلام النتائج وحفظها
Ailoot Ultra · فيديو
عناوين URL موقّعة لمحتوى مملوك لك
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
التحقق من حالة المهمة
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
عمليات أخرى لقراءة المحتوى
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
الاحتفاظ بكل النتائج المكتملة
احفظ كل فيديو مكتمل أو ملف مُرجع؛ ونزّل كل أصل من URL الخاص به الذي تم إرجاعه فعليًا.
احتفظ بكل مخرج فعلي مملوك لك وبالبيانات الوصفية المقاسة المُعادة معه.
عند الحاجة إلى التحقق من الاستجابة الأصلية
503 result_pending_check + المعرّف الأصلي + X-Should-Retry:false؛ لا تعِد تنفيذ العملية الأصلية مطلقاً
حقول الاستجابة
| الحقل | النوع | المعنى |
|---|---|---|
الحقلindex | النوعinteger | المعنىموضع هذا الفيديو في قائمة المخرجات، بدءاً من الصفر. |
الحقلcontent_url | النوعstring | المعنىعنوان URL موقّع عبر HTTPS لتنزيل هذا الفيديو المكتمل. |
الحقلsha256 | النوعstring | null | المعنىبصمة SHA-256 لبايتات الفيديو الأصلي؛ وتكون القيمة null إذا لم تتوفر. |
الحقلsize_bytes | النوعinteger | null | المعنىحجم ملف الفيديو الأصلي بالبايت؛ وتكون القيمة null إذا لم يتوفر. |
الحقلduration_ms | النوعinteger | null | المعنىمدة الفيديو المقاسة بالمللي ثانية؛ وتكون القيمة null إذا لم تتوفر. |
الحقلwidth | النوعinteger | null | المعنىعرض الفيديو بالبكسل؛ وتكون القيمة null إذا لم يتوفر. |
الحقلheight | النوعinteger | null | المعنىارتفاع الفيديو بالبكسل؛ وتكون القيمة null إذا لم يتوفر. |
الحقلvideo_codec | النوعstring | null | المعنىمعرّف ترميز الفيديو؛ وتكون القيمة null إذا لم يُسجَّل. |
الحقلhas_audio | النوعboolean | null | المعنىما إذا كان الفيديو يحتوي على مسار صوتي؛ وتكون القيمة null إذا لم يُقَس ذلك. |
الحقلaudio_codec | النوعstring | null | المعنىمعرّف ترميز الصوت؛ وتكون القيمة null إذا لم يُسجَّل معرّف. |
الأخطاء والخطوات التالية
| الاستجابة | الشرط | الخطوة التالية |
|---|---|---|
الاستجابة404 · not_found_error | الشرطالوصول إلى الفيديو غير متاح، أو لم يُعثر على معرّف الفيديو هذا. | الخطوة التاليةتحقق من الوصول إلى الفيديو. للفيديو الموجود، استخدم معرّفه العام الأصلي ومفتاح API نفسه. |
الاستجابة401 · authentication_error | الشرطمفتاح API لا يطابق الحساب الذي تمت المصادقة عليه. | الخطوة التاليةتحقق من مفتاح API وإمكانية وصول حسابك قبل الإرسال. |
الاستجابة400 · invalid_request_error | الشرطتعذرت قراءة الطلب، أو فهرس التنزيل غير صالح. | الخطوة التاليةصحّح متن الطلب. للتنزيل، اختر فهرس مخرج أعادته المهمة الأصلية. |
الاستجابة422 · price_unavailable | الشرطيتعذر تسعير إعداد الفيديو المختار. | الخطوة التاليةاختر إعداد فيديو مدعوماً وأكمل خياراته المطلوبة قبل إرسال طلب مصحح. |
الاستجابة422 · invalid_request_error | الشرطإدخال الفيديو أو مهمة المتابعة الأصلية غير صالح. | الخطوة التاليةاستخدم مدخلات HTTPS صالحة. للمتابعة، استخدم المعرّف العام للفيديو الأصلي المكتمل لديك مع مفتاح API نفسه. |
الاستجابة402 · billing_error | الشرطالرصيد المتاح أو الحدود المقررة لا تسمح بحجز الرصيد. | الخطوة التاليةتحقق من رصيدك المتاح وحدودك قبل إرسال طلب جديد. |
الاستجابة503 · server_error | الشرطالتحقق من الفيديو أو التخزين أو الوصول إلى الخدمة غير متاح مؤقتاً. | الخطوة التاليةانتظر إتاحة الخدمة. إذا كان لديك معرّف فيديو بالفعل، فتحقق من تلك المهمة الأصلية بدلاً من إنشاء عملية توليد أخرى. |
الاستجابة503 · result_pending_check | الشرطتحتاج نتيجة الفيديو الأصلية والرسم المحتسب إلى التحقق. | الخطوة التاليةاحتفظ بمعرّف الفيديو المُعاد وتحقق من تلك المهمة. لا ترسل طلب توليد بديل أثناء التحقق منها. |
الاستجابة503 · owned_result_unavailable | الشرطتنزيل الفيديو الموجود غير متاح مؤقتاً. | الخطوة التاليةتحقق من مهمة الفيديو نفسها لاحقاً ونزّل مخرجها الموجود. ينشئ التوليد الجديد عملية منفصلة. |
الاستجابة409 · video_not_ready | الشرطلم يُنشر محتوى الفيديو. | الخطوة التاليةتحقق من حالة المهمة الأصلية. نزّل المخرجات بعد أن تُبلِغ عن completed؛ وإذا أبلغت عن failed، فاتبع إشعارها المتعلق بالتحقق من الرسم المحتسب. |
الأسماء البديلة
الأسماء البديلة للنموذج
Ailoot Ultra kwaivgi/kling-v3.0-pro
الأسماء البديلة لمسارات الطرائق
استخدم مسارات الطرائق المعروضة أعلاه.
معرّفات النماذج ذات الصلة IDs
FAQ · Kling: Video v3.0 Pro
- ما المدخلات والنتائج المتاحة؟
POST /v1/videos·kwaivgi/kling-v3.0-pro:text,image→video- ما الحقول التي يستخدمها الطلب؟
POST /v1/videos·kwaivgi/kling-v3.0-pro:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,size,callback_url,session_id,trace,user- ما الحدود المطبقة؟
POST /v1/videos·kwaivgi/kling-v3.0-pro:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1