Higgsfield: DOP Lite

يحرّك DOP Lite صورة مقدّمة باستخدام قوالب حركة موثّقة وقوة قابلة للضبط وتوجيهات مكتوبة. يستخدم هذا المحدِّد الدقيق dop-lite طلب تحويل صورة إلى فيديو ويعيد الفيديو عبر مهمة غير متزامنة.

Ailoot Ultra · فيديو POST /v1/videos dop-lite

عن النموذج

يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.

يحرّك DOP Lite الصور المقدّمة عبر سير عمل Higgsfield الموثّق لتحويل صورة إلى فيديو. المحدِّد الدقيق هو dop-lite. استخدم dop-lite لاختيار model في المستوى الأعلى، وكذلك لقيمة model داخل كائن params الموثّق. توفّر الصورة المادة البصرية، بينما تتحكم قوالب الحركة والتوجيهات المكتوبة في الحركة والتأثير المطلوبين.

أعدّ صورة مرجعية يكون فيها الموضوع المقصود والتفاصيل المهمة والمساحة المحيطة واضحة. يوصي الدليل بصورة عالية الدقة لإظهار التفاصيل بوضوح أكبر. لمشهد منتج، اختر زاوية تُظهر شكل الجسم والأسطح التي ينبغي أن تظل قابلة للتعرّف أثناء الحركة. ولشخص أو بيئة، حدّد السمة البصرية التي ينبغي أن تبرزها الحركة. قدّم عنوان URL الفعلي للصورة المرجعية عبر مدخل الصورة المستخدم في مثال الطريقة.

توثّق العملية قالب حركة واحدًا أو قالبين. عند تقديم قالبين، يصف الدليل تأثيريهما بأنهما مدمجان. تشمل أوصاف الإعدادات المسبقة حركة الكاميرا ودوران الموضوع والتحولات البصرية؛ فمثلًا، يصف Dolly In اقتراب الكاميرا، بينما يصف 3D Rotation دوران موضوع أو منتج في مكانه. اختر معرّفات القوالب الموثّقة التي توافق التسلسل المقصود، واحتفظ بكل معرّف مع قيمة قوته.

قوة الحركة عدد من 0 إلى 1، مع 0.8 بوصفه القيمة الافتراضية الموثّقة. يصف الدليل 0.3 بأنه تأثير خفيف، و1 بأنه حركة قوية. اختر الشدة وفق التفصيل الذي يجب أن يظل واضحًا، وراجع الحركة المولّدة كاملة. لوصف الحركة وقوتها غرضان مختلفان: يختار القالب التأثير، بينما تتحكم القوة في شدته.

يجب أن يكون حقل prompt موجودًا وفق وصفه، لكن يُسمَح بسلسلة نصية فارغة. للتأثيرات الموجّهة بالقوالب، يوصي الدليل بترك prompt فارغًا؛ وعند تقديم نص، يوصي بتضمين وصف القالب لأن الموجّه قد يغيّر النتيجة بقوة. يفعّل عنصر التحكم enhance_prompt تحسين الموجّه، وهو موثّق بقيمة true افتراضيًا. احتفظ بالنص وعنصر التحكم هذا مع الصورة المرجعية والقوالب المختارة عند مقارنة النسخ.

يقبل عنصر التحكم seed عددًا صحيحًا من 1 إلى 1000000. سجّل قيمة seed المختارة مع إعدادات التوليد. يتيح الطلب أيضًا حقل seconds من نوع عدد صحيح؛ واحتفظ بالقيمة المستخدمة مع المقطع الناتج وافحص توقيته وتأطيره الفعليين. تفعّل القيمة المنطقية check_nsfw مرشّح المحتوى الموثّق، وقيمتها الافتراضية true. تنتمي هذه الضوابط إلى طلب تحويل صورة إلى فيديو، وينبغي أن تبقى مرتبطة بالنموذج المحدد بعينه.

التوليد غير متزامن. احتفظ بمعرّف المهمة المعاد أثناء متابعة الاستعلام المهيّأ للحالة والنتيجة. تقرأ آلية تعيين الاكتمال سجلات المهام المكتملة وعناوين URL الخام لنتائجها. احفظ كل نتيجة فيديو مكتملة، واحتفظ بمعرّف مهمتها مع عنوان URL المعاد، مع إبقاء جميع السجلات المكتملة معًا بوصفها نتيجة العملية.

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

Ailoot Ultra · فيديو POST /v1/videos dop-lite

dop-lite

Higgsfield /dop-lite

البداية

المدخلات المقبولة: الصور · النص
النتائج: فيديو

متاح في Ailoot · المدخلات والطرائق

Ailoot Ultra · فيديو POST /v1/videos

الإدخال: image, text
الإخراج: video

الحقل	النوع	المتطلب	القيم والحدود	القيمة الافتراضية
الحقل`model`	النوع`string`	المتطلبمطلوب	القيم والحدود dop-lite الشروط: محدِّد نموذج Ailoot.	القيمة الافتراضية—
الحقل`params`	النوع`object`	المتطلبمطلوب	القيم والحدود الشروط: معلمات تحويل الصورة إلى فيديو؛ حافظ على هذه البنية الحاوية.	القيمة الافتراضية—
الحقل`params.model`	النوع`string`	المتطلبمطلوب	القيم والحدود dop-lite الشروط: استخدم المحدِّد نفسه المستخدم في حقل model بالمستوى الأعلى.	القيمة الافتراضية—
الحقل`params.prompt`	النوع`string`	المتطلبمطلوب	القيم والحدود الشروط: أبقِ هذا الحقل موجوداً؛ فالسلسلة النصية الفارغة موثّقة. تؤثر الإرشادات المكتوبة بشدة في تأثير الحركة المختار.	القيمة الافتراضية—
الحقل`params.seconds`	النوع`integer`	المتطلباختياري	القيم والحدود الشروط: المدة المطلوبة؛ ولا يُفترض نطاق موثّق أو قيمة افتراضية.	القيمة الافتراضية—
الحقل`params.motions`	النوع`array`	المتطلباختياري	القيم والحدود الشروط: اختر قالب حركة واحداً أو قالبين من القوالب الموثّقة.	القيمة الافتراضية—
الحقل`params.motions[].id`	النوع`string`	المتطلبمطلوب	القيم والحدود الشروط: معرّف الحركة الوارد في مثال الطلب العامل الموثّق.	القيمة الافتراضية—
الحقل`params.motions[].strength`	النوع`number`	المتطلبمطلوب	القيم والحدود الحد الأدنى: ⁦0⁩ الحد الأقصى: ⁦1⁩ الشروط: شدة الحركة: توصف 0.3 بأنها خفيفة و1 بأنها قوية.	القيمة الافتراضية⁦0.8⁩
الحقل`params.input_images`	النوع`array`	المتطلباختياري	القيم والحدود الشروط: صور مرجعية، باستخدام مصفوفة كائنات image_url المبينة في المثال العامل.	القيمة الافتراضية—
الحقل`params.input_images[].type`	النوع`string`	المتطلبمطلوب	القيم والحدود image_url الشروط: صيغة تمثيل المرجع.	القيمة الافتراضية—
الحقل`params.input_images[].image_url`	النوع`string`	المتطلبمطلوب	القيم والحدود الشروط: عنوان URL الفعلي لصورتك المرجعية الذي يمكن الوصول إليه.	القيمة الافتراضية—
الحقل`params.enhance_prompt`	النوع`boolean`	المتطلباختياري	القيم والحدود الشروط: تحسين الموجّه النصي.	القيمة الافتراضيةtrue
الحقل`params.check_nsfw`	النوع`boolean`	المتطلباختياري	القيم والحدود الشروط: تصفية المحتوى.	القيمة الافتراضيةtrue
الحقل`params.seed`	النوع`integer`	المتطلباختياري	القيم والحدود الحد الأدنى: ⁦1⁩ الحد الأقصى: ⁦1,000,000⁩ الشروط: بذرة للحصول على مخرجات متسقة.	القيمة الافتراضية—
الحقل`webhook`	النوع`object`	المتطلباختياري	القيم والحدود الشروط: إعدادات webhook اختيارية موثّقة؛ ويستخدم استرجاع النتائج المملوكة لك مسارات مهام Ailoot.	القيمة الافتراضية—
الحقل`webhook.url`	النوع`string`	المتطلباختياري	القيم والحدود الشروط: عنوان URL للمستقبِل لديك.	القيمة الافتراضية—
الحقل`webhook.secret`	النوع`string`	المتطلباختياري	القيم والحدود الشروط: السر الخاص بالمستقبِل لديك.	القيمة الافتراضية—
الحقل`callback`	النوع`string`	المتطلباختياري	القيم والحدود الشروط: مستقبِل callback اختياري؛ يستجيب المستقبِل الموثّق بالرمز HTTP 200.	القيمة الافتراضية—

تركيبات مواد الإدخال

معلمات الطريقة ودورة حياتها

المعلمة	المواصفات
المعلمة`content_type`	المواصفاتapplication/json
المعلمة`required`	المواصفاتmodel, params
المعلمة`optional`	المواصفاتparams.seconds, params.motions, params.input_images, params.enhance_prompt, params.check_nsfw, params.seed, webhook, webhook.url, webhook.secret, callback
المعلمة`material_types`	المواصفاتimage, text
المعلمة`additional_properties`	المواصفاتtrue
المعلمة`validation_scope`	المواصفاتيوجّه النموذج الطلب؛ وتتبع البنية الحاوية للمعلمات طلب تحويل الصورة إلى فيديو الموضّح.

الأسماء البديلة للطريقة: /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/videos/generations/{request_id}/content

استخدم محدِّد النموذج نفسه في المستوى الأعلى وداخل params.

أنشئ مرة واحدة، ثم استخدم id العام وpolling_url المُعادين للعملية الأصلية.

استرجع كل فيديو مكتمل مملوك لك؛ وافحص المدة والأبعاد الفعلية في النتيجة.

استبدل YOUR_ACCESSIBLE_IMAGE_URL في المثال بعنوان URL الفعلي لصورتك المرجعية.

الباقات

كيفية احتساب الرسوم النهائية

تقدّر التعرفات المعروضة التكلفة قبل التوليد. تُحسب الرسوم النهائية من التكلفة المسجّلة لعملية التوليد الأصلية. مدة المخرجات المقاسة والكميات المتوقعة ليست الكمية النهائية الخاضعة للفوترة.

مراجع التسعير لا تضيف خيارات للطلب. المعلمات المدعومة مذكورة للطريقة المحددة.

الوضع السريع: غير محدد عند اختيار الوضع السريع
الوضع المرن: غير محدد عند اختيار وضع flex
أقصى جهد للاستدلال: غير محدد عندما يُطبَّق الضبط الافتراضي default مع أقصى جهد للاستدلال

تعرفات تقديرية للمقارنة

الأسعار حسب الإعدادات

طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة.

الإعدادات	جدول التعرفة	الكمية المتوقعة	الرسوم
الإعداداتالتعرفات الأساسية للرموز	جدول التعرفةالتعرفة الأساسية	الكمية المتوقعة—	الرسوم الإدخال · رموز الإدخال · تقدير للمقارنة فقط — / 1K من الرموز الإخراج · رموز الإخراج · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة · تقدير للمقارنة فقط — / 1K من الرموز
الإعداداتتكلفة التوليد التقديرية	جدول التعرفة—	الكمية المتوقعةتقدير لتوليد واحد	الرسوم الإخراج · تكلفة التوليد التقديرية · تقدير للمقارنة فقط $1.24 تقدير قبل الإنشاء هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة.

تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →

أمثلة للطلبات

Ailoot Ultra · فيديو

JSON · أنشئ فيديوcurl · اقرأ المهمة الأصلية

{
  "model": "dop-lite",
  "params": {
    "model": "dop-lite",
    "prompt": "a cat",
    "seed": 500000,
    "motions": [
      {
        "id": "2bae49e6-ffe7-42a8-a73f-d44632c4acaa",
        "strength": 0.5
      }
    ],
    "input_images": [
      {
        "type": "image_url",
        "image_url": "YOUR_ACCESSIBLE_IMAGE_URL"
      }
    ],
    "enhance_prompt": true,
    "check_nsfw": true
  }
}

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_POLL'
import json
from pathlib import Path
from urllib.parse import quote,urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
i=r.get("id")
if not isinstance(i,str) or not i:raise SystemExit("Keep original response/headers/id; do not resubmit creation.")
u=urljoin("https://api.ailoot.ai",r.get("polling_url") or "/v1/videos/"+quote(i,safe=""))
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/videos/"):raise SystemExit("Use the actual Ailoot lookup path.")
Path("poll-url.txt").write_text(u)
PY_POLL
curl --fail-with-body --silent --show-error "$(cat poll-url.txt)" -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json

استلام النتائج وحفظها

Ailoot Ultra · فيديو

احتفظ بالمهام المُعادة وحالاتها. اقرأ نتيجة كل فيديو مكتمل مملوك لك.

GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content

الاحتفاظ بكل النتائج المكتملة

احفظ كل فيديو مكتمل أو ملف مُرجع؛ ونزّل كل أصل من URL الخاص به الذي تم إرجاعه فعليًا.

اجلب كل مخرج فعلي مكتمل؛ ولا تفترض عدداً ثابتاً.

عند الحاجة إلى التحقق من الاستجابة الأصلية

احتفظ بالاستجابة الأصلية وهوية المهمة المُعادة؛ ولا تمنح حالة غير معروفة أو عملية إرسال ملتبسة الإذن بإنشاء مهمة جديدة.

حقول الاستجابة

الحقل	النوع	المعنى
الحقل`id`	النوعstring	المعنىالمعرّف العام لمهمة أو عملية في Ailoot.
الحقل`provider_task_id`	النوعstring	المعنىمعرّف المهمة الأصلي، المنفصل عن id العام.
الحقل`polling_url`	النوعstring	المعنىمسار الاستعلام المُعاد في Ailoot.
الحقل`jobs[].id`	النوعstring	المعنىمعرّف المهمة الفعلي المُعاد.
الحقل`jobs[].status`	النوعstring	المعنىحالة كل مهمة مُعادة.
الحقل`jobs[].results.raw.url`	النوعstring	المعنىيُتاح كل فيديو مكتمل عبر عنوان URL موقّع تابع لـAiloot.

الأخطاء والخطوات التالية

الاستجابة	الشرط	الخطوة التالية
الاستجابة⁦400⁩ · `invalid_request_error`	الشرطJSON أو النموذج غير صالح، أو فهرس المحتوى غير صالح.	الخطوة التالية
الاستجابة⁦401⁩ · `authentication_error`	الشرطمفتاح API الخاص بـAiloot غير صالح.	الخطوة التالية
الاستجابة⁦403⁩ · `permission_error`	الشرطمجموعة مفتاح API غير مخوّلة لاستخدام مسار الوسائط هذا.	الخطوة التالية
الاستجابة⁦404⁩ · `not_found_error`	الشرطالمهمة الأصلية أو المخرج المطلوب غير موجود، أو غير مملوك للمستخدم ومفتاح API والمجموعة نفسها.	الخطوة التالية
الاستجابة⁦502⁩ · `result_pending_check`	الشرطالإرسال الأصلي أو حالته غير مكتملين، أو يتعذر التحقق من اتساقهما؛ احتفظ بالمعرّف الأصلي ولا تعِد الإرسال.	الخطوة التالية
الاستجابة⁦503⁩ · `result_pending_check`	الشرطلا يزال الربط الأصلي أو المسار أو الوسائط المملوكة لك قيد التحقق؛ تابع التحقق من تلك العملية الأصلية.	الخطوة التالية
الاستجابة⁦503⁩ · `server_error`	الشرطخدمة الوسائط أو مخزن المهمة الأصلية غير متاح.	الخطوة التالية

الأسماء البديلة

الأسماء البديلة للنموذج

Ailoot Ultra dop-lite

الأسماء البديلة لمسارات الطرائق

/v1/videos/generations

معرّفات النماذج ذات الصلة IDs

dop-lite

FAQ · Higgsfield: DOP Lite

ما المدخلات والنتائج المتاحة؟: POST /v1/videos · dop-lite: image, text → video
ما الحقول التي يستخدمها الطلب؟: POST /v1/videos · dop-lite: model, params, webhook, callback
ما الحدود المطبقة؟: POST /v1/videos · dop-lite: params.motions[].strength.minimum: 0; params.motions[].strength.maximum: 1; params.seed.minimum: 1; params.seed.maximum: 1000000

Higgsfield: DOP Lite