kling-v1-6
يولّد ملف kling-v1-6 الفيديو من وصف مكتوب للمشهد. خطّط للقطة قصيرة بموضوع وفعل واتجاه كاميرا واضحين، باستخدام خياري المدة الموثّقين: خمس أو عشر ثوانٍ. التوليد غير متزامن: احتفظ بهوية المهمة المُعادة واسترجع الفيديو المكتمل بعد نجاح المهمة الأصلية.
عن النموذج
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
يعرّف المحدِّد الدقيق kling-v1-6 ملف Kling لتحويل النص إلى فيديو. أرسل JSON إلى POST /v1/videos/generations مع ضبط model على kling-v1-6 ووضع المشهد المكتوب في prompt. يقبل POST /v1/videos أيضًا طلب التوليد نفسه. يصف الطلب الواضح ما يظهر، وما يحدث أثناء اللقطة، وكيف تراقبه الكاميرا. يقدّم طلب المشهد الأدنى محدِّد النموذج وprompt، ويترك عناصر التحكم الإضافية باللقطة دون تحديد.
للقطة منتج، صِف العنصر والسطح والإضاءة وفعلًا مرئيًا واحدًا، مثل دوران بطيء أو تغيير في موضع الكاميرا. ولتصور مشهد، حدّد البيئة والموضوع الرئيسي والحركة عبر الإطار. أبقِ الفعل مقروءًا ضمن المقطع المطلوب. يمكن أن يصف prompt قاربًا صغيرًا يعبر بحيرة ساكنة، ومنظرًا واسعًا من الضفة، وضوء الصباح الباكر، وكاميرا ثابتة الحركة تتبع اتجاه القارب.
حد prompt هو 500 محرف. ويمكن أن يحتوي negative_prompt الاختياري على ما يصل إلى 200 محرف، ويصف العناصر غير المرغوب فيها. خيارات duration الموثّقة لهذا الملف هي 5 و10 ثوانٍ. قيم mode هي std وpro. cfg_scale عدد من 0 إلى 1؛ وتصف الوثائق القيم الأعلى بأنها التزام أقوى بالنص. اختر عناصر التحكم للقطة المحددة واحتفظ بالقيم المرسلة مع النتيجة.
يسرد كائن camera_control الموثّق أنواع الكاميرا simple وdown_back وforward_up وright_turn_forward وleft_turn_forward. وتسمّي تهيئة simple الخاصة به عناصر التحكم horizontal وvertical وpan وtilt وroll وzoom. يوفّر المثال النصي الأدنى نقطة بداية مفيدة عندما يمكن وصف المشهد دون كائن منفصل للتحكم بالكاميرا. امنح حركة الكاميرا غرضًا واضحًا في prompt، مثل الكشف عن الموضوع أو متابعة حركته.
يبدأ الإرسال مهمة غير متزامنة. احتفظ بـ id المُعاد وترويسة X-Ailoot-Task-Id وpolling_url، ثم استخدم GET على polling_url نفسه وبمفتاح Ailoot API نفسه لقراءة المهمة الأصلية. حالة المهمة في data.task_status: الحالتان submitted وprocessing قيد الانتظار، وsucceed تعني النجاح، وfailed تعني الإخفاق. لذلك فإن إقرار الإرسال نتيجة وسيطة. عند النجاح، استرجع كل URL في data.task_result.videos[].url؛ فهذه روابط ملفات نتائج يديرها Ailoot. يسترجع GET /v1/videos/{id}/content المخرج الأول، ويختار معامل الاستعلام index مخرجًا مُعادًا بفهرسه الذي يبدأ من الصفر. احتفظ باستجابة الحالة مع المقطع المختار. وإذا حدث انتهاء مهلة أو استجابة result_pending_check، فاحتفظ بالهوية الأصلية المُعادة وافحص تلك العملية بدل إرسال اللقطة مجددًا.
راجع اللقطات المكتملة طوال مدتها: فالفعل المقصود ومظهر الموضوع والتأطير والحركة كلها أجزاء من موجز اللقطة. يوفّر هذا الملف تحديدًا مسار تحويل النص إلى فيديو الموصوف هنا. ينبغي متابعة أي مهمة مُعادة لا تزال بحاجة إلى فحص حالة باستخدام هويتها الأصلية، بما في ذلك عندما تنتهي مهلة طلب العميل؛ احتفظ بمعلومات تلك المهمة قبل التفكير في طلب توليد جديد.
Ailoot Ultra · Video POST /v1/videos kling-v1-6
kling-v1-6البداية
يولّد ملف kling-v1-6 الفيديو من وصف مكتوب للمشهد. خطّط للقطة قصيرة بموضوع وفعل واتجاه كاميرا واضحين، باستخدام خياري المدة الموثّقين: خمس أو عشر ثوانٍ. التوليد غير متزامن: احتفظ بهوية المهمة المُعادة واسترجع الفيديو المكتمل بعد نجاح المهمة الأصلية.
- المدخلات المقبولة
- النص
- النتائج
- فيديو
متاح في Ailoot · المدخلات والطرائق
Ailoot Ultra · Video POST /v1/videos
- الإدخال
text- الإخراج
video
| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود kling-v1-6 | القيمة الافتراضية— |
الحقلprompt | النوعstring | المتطلبمطلوب | القيم والحدود | القيمة الافتراضية— |
الحقلmode | النوعstring | المتطلبمطلوب | القيم والحدود std, pro | القيمة الافتراضية— |
الحقلmodel_name | النوعstring | المتطلباختياري | القيم والحدود kling-v1-6 | القيمة الافتراضية— |
الحقلcfg_scale | النوعnumber | المتطلباختياري | القيم والحدود الحد الأدنى: 0 الحد الأقصى: 1 | القيمة الافتراضية— |
الحقلaspect_ratio | النوعstring | المتطلباختياري | القيم والحدود | القيمة الافتراضية— |
الحقلnegative_prompt | النوعstring | المتطلباختياري | القيم والحدود | القيمة الافتراضية— |
الحقلduration | النوعinteger | المتطلباختياري | القيم والحدود 5, 10 | القيمة الافتراضية— |
معلمات الطريقة ودورة حياتها
| المعلمة | المواصفات |
|---|---|
المعلمةcontent_type | المواصفاتapplication/json |
المعلمةrequired | المواصفاتmodel, prompt, mode |
المعلمةoptional | المواصفاتmodel_name, cfg_scale, aspect_ratio, negative_prompt, duration |
المعلمةmaterial_types | المواصفاتtext |
المعلمةconditions | المواصفاتmodel selects this model. An omitted model_name uses the selected model; an explicit native model_name override is preserved. |
الأسماء البديلة للطريقة: /v1/videos/generations
دورة الحياة: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
الباقات
كيفية احتساب الرسوم النهائية
تقدّر التعرفات المعروضة التكلفة قبل التوليد. تُحسب الرسوم النهائية من التكلفة المسجّلة لعملية التوليد الأصلية. مدة المخرجات المقاسة والكميات المتوقعة ليست الكمية النهائية الخاضعة للفوترة.
مراجع التسعير لا تضيف خيارات للطلب. المعلمات المدعومة مذكورة للطريقة المحددة.
- الوضع السريع
- غير محدد عند اختيار الوضع السريع
- الوضع المرن
- غير محدد عند اختيار وضع flex
- أقصى جهد للاستدلال
- غير محدد عندما يُطبَّق الضبط الافتراضي default مع أقصى جهد للاستدلال
تعرفات تقديرية للمقارنة
الأسعار حسب الإعدادات
طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة.
| الإعدادات | جدول التعرفة | الكمية المتوقعة | الرسوم |
|---|---|---|---|
| الإعداداتالتعرفات الأساسية للرموز | جدول التعرفةالتعرفة الأساسية | الكمية المتوقعة— | الرسوم الإدخال · رموز الإدخال · تقدير للمقارنة فقط — / 1K من الرموز الإخراج · رموز الإخراج · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة · تقدير للمقارنة فقط — / 1K من الرموز |
| الإعداداتEstimated generation cost | جدول التعرفة— | الكمية المتوقعةتقدير لتوليد واحد | الرسوم الإدخال · تكلفة التوليد التقديرية · تقدير للمقارنة فقط $6 تقدير قبل الإنشاء This estimate is not an additional charge or a fixed rate for the completed generation. |
تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →
أمثلة للطلبات
Ailoot Ultra · Video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "kling-v1-6", "prompt": "A happy holiday scene at the beach.", "mode": "pro"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
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
# Submit once. Retain the complete result, original identifiers and every response header.
استلام النتائج وحفظها
Ailoot Ultra · Video
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
الاحتفاظ بكل النتائج المكتملة
احفظ كل فيديو مكتمل أو ملف مُرجع؛ ونزّل كل أصل من URL الخاص به الذي تم إرجاعه فعليًا.
Retain the complete response, all actual results, original identifiers, usage and response headers.
عند الحاجة إلى التحقق من الاستجابة الأصلية
Keep the returned public task or operation id and all headers. Read only the original task; unknown or result_pending_check does not authorize another creation.
حقول الاستجابة
| الحقل | النوع |
|---|---|
الحقلdata.task_result.videos[].url | النوعstring or array, as returned |
الأسماء البديلة
الأسماء البديلة للنموذج
Ailoot Ultra kling-v1-6
الأسماء البديلة لمسارات الطرائق
/v1/videos/generations
معرّفات النماذج ذات الصلة IDs
FAQ · kling-v1-6
- ما المدخلات والنتائج المتاحة؟
POST /v1/videos·kling-v1-6:text→video- ما الحقول التي يستخدمها الطلب؟
POST /v1/videos·kling-v1-6:model,prompt,mode,model_name,cfg_scale,aspect_ratio,negative_prompt,duration- ما الحدود المطبقة؟
POST /v1/videos·kling-v1-6:cfg_scale.minimum:0;cfg_scale.maximum:1