Black Forest Labs: FLUX Video Upscale

يكبّر FLUX Video Upscale مقطعًا موجودًا بتحسين تفاصيل يحافظ على المصدر أو يتعامل معها إبداعيًا. توفر مواصفاته الموثّقة تكبيرًا من 1.5×–3×، وتحافظ على صوت المصدر وتأطيره، وتحدّ طول المصدر ودقة الإدخال ومساحة إطار الإخراج.

Ailoot Ultra · فيديو POST /v1/videos black-forest-labs/flux-video-upscale

عن النموذج

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

FLUX Video Upscale هو سير عمل Black Forest Labs لرفع دقة الفيديو، ويعمل بتقنية FLUX 3. يتلقى مقطعًا موجودًا ويعيد MP4 مكبّرًا مع نقل تأطير المصدر وصوته إلى النتيجة. ويمكن لوصف اختياري قصير توجيه التفاصيل البصرية المحسّنة. يتيح وضعاه اختيارًا مهمًا بين الاقتراب من المظهر المقدّم وتوليد تفاصيل أقوى، بدل اعتبار كل صورة أكبر إعادة بناء متساوية الأمانة للمصدر.

اختر تحسينًا دقيقًا أو إبداعيًا

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

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

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

التكبير ومساحة إطار الإخراج

يتراوح upscale_factor الموثّق من 1.5 إلى 3، مع 2 افتراضيًا. يكبّر دقة المصدر مع حفظ نسبة العرض. يحدد العامل المختار وأبعاد الإدخال المخرج المقصود، لذا يجب تخطيط مقطع أفقي وتكوين عمودي انطلاقًا من إطاراتهما الفعلية. أعدّ حجم العرض المستهدف قبل اختيار مقدار التكبير المفيد.

تحد المواصفات الدقيقة كل إطار إخراج بـ13.75 من وحدات الميغابكسل لدى الشركة المصنّعة. وتعرّف وثائقها الوحدة الواحدة بأنها 1,048,576 بكسل، ما يعطي سقفًا قدره 14,417,920 بكسل، أي نحو 14.4 مليونًا. يفسر ذلك عبارة 14.4 ميغابكسل المدوّرة في الدليل. لذلك قد يحصل المصدر الكبير على تكبير أقل من العامل المطلوب. افحص الأبعاد المقدّمة بدل افتراض أن طلب 3× ينتج دائمًا ثلاثة أمثال كل بُعد للمصدر.

سقف دقة المصدر المنشور هو 2560×1440. يرفع هذا المسار مصدرًا مؤهلًا نحو 4K وما بعده؛ ولا يقبل مصدرًا أكبر أصلًا لمجرد الرغبة في مخرج أعلى. صغّر المصدر أو أعدّ نسخة عمل مناسبة قبل استخدام النمط الموثّق. احتفظ بالتسجيل الأصلي منفصلًا حتى لا تقتصر المقارنة النهائية على وسيط غُيّر حجمه.

أعدّ مصدرًا قصيرًا واضحًا

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

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

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

احفظ المقطع المقدّم وتحقّق منه

سير عمل الجهة المنتجة غير متزامن: توفر المهمة المرسلة هوية وموقع حالة، وتتضمن نتيجتها المكتملة رابط تسليم MP4 موقّعًا. ينتهي هذا الرابط بعد نحو ساعة. احتفظ بالمقطع الفعلي والمصدر والعامل المختار ووضع creativity ووصف المحتوى بدل الاعتماد على الموقع المؤقت. ميّز الحالة الفاشلة أو الخاضعة للمراجعة عن فيديو مكتمل.

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

Ailoot Ultra · فيديو POST /v1/videos black-forest-labs/flux-video-upscale

black-forest-labs/flux-video-upscale

Black Forest Labs /black-forest-labs/flux-video-upscale

البداية

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

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

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

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

الحقل	النوع	المتطلب	القيم والحدود	القيمة الافتراضية
الحقل`model`	النوع`string`	المتطلبمطلوب	القيم والحدود black-forest-labs/flux-video-upscale	القيمة الافتراضية—
الحقل`input_references`	النوع`array`	المتطلبمطلوب	القيم والحدود الحد الأدنى للعناصر: ⁦1⁩ الحد الأقصى للعناصر: ⁦1⁩	القيمة الافتراضية—
الحقل`upscale_factor`	النوع`number`	المتطلبمطلوب	القيم والحدود الحد الأدنى: ⁦1.5⁩ الحد الأقصى: ⁦3⁩	القيمة الافتراضية—
الحقل`creativity`	النوع`integer`	المتطلبمطلوب	القيم والحدود ⁦0⁩, ⁦1⁩	القيمة الافتراضية—

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

المعلمة	المواصفات
المعلمة`content_type`	المواصفاتapplication/json
المعلمة`required`	المواصفاتmodel, input_references, upscale_factor, creativity
المعلمة`material_types`	المواصفاتtext, image, audio, video
المعلمة`material_conditions`	المواصفاتاستخدم عنوان URL فعلياً واحداً بالضبط لمحتوى أصل فيديو مكتمل ومملوك لك، مع توقيعه المُعاد. يجب أن يطابق مالك الأصل ونوعه ودليل البايتات المخزّنة الطلب.

دورة الحياة: asynchronous_job_then_owned_outputs

GET /v1/videos/{request_id} · القيمة الفعلية المُعادة للحقل id أو polling_url

GET /v1/videos/{request_id}/content

الباقات

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

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

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

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

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

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

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

الإعدادات	جدول التعرفة	الكمية المتوقعة	وحدة الفوترة	شروط الفوترة	عدد البكسلات لكل ميغابكسل	الرسوم
الإعداداتالتعرفات الأساسية للرموز	جدول التعرفةالتعرفة الأساسية	الكمية المتوقعة—	وحدة الفوترة—	شروط الفوترة—	عدد البكسلات لكل ميغابكسل—	الرسوم الإدخال · رموز الإدخال · تقدير للمقارنة فقط — / 1K من الرموز الإخراج · رموز الإخراج · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة · تقدير للمقارنة فقط — / 1K من الرموز
الإعداداتسعر الفيديو	جدول التعرفة—	الكمية المتوقعة—	وحدة الفوترةلكل ميغابكسل-ثانية	شروط الفوترةالجودة: creative	عدد البكسلات لكل ميغابكسل⁦1,048,576⁩	الرسوم الإخراج · سعر الفيديو · تقدير للمقارنة فقط $0.21 لكل ميغابكسل-ثانية
الإعداداتسعر الفيديو	جدول التعرفة—	الكمية المتوقعة—	وحدة الفوترةلكل ميغابكسل-ثانية	شروط الفوترةquality: precise	عدد البكسلات لكل ميغابكسل⁦1,048,576⁩	الرسوم الإخراج · سعر الفيديو · تقدير للمقارنة فقط $0.15 لكل ميغابكسل-ثانية
الإعداداتتكلفة التوليد التقديرية	جدول التعرفة—	الكمية المتوقعةتقدير لتوليد واحد	وحدة الفوترة—	شروط الفوترة—	عدد البكسلات لكل ميغابكسل—	الرسوم الإخراج · تكلفة التوليد التقديرية · تقدير للمقارنة فقط $0.15 تقدير قبل الإنشاء هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة.

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

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

Ailoot Ultra · فيديو

استخدم المدخلات الفعلية واحتفظ بالنتيجة كاملة

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_INPUT_REFERENCES_JSON:?Set the actual documented input value}"
export AILOOT_INPUT_REFERENCES_JSON
: "${AILOOT_UPSCALE_FACTOR:?Set the actual documented input value}"
export AILOOT_UPSCALE_FACTOR
: "${AILOOT_CREATIVITY:?Set the actual documented input value}"
export AILOOT_CREATIVITY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
request={'model': 'black-forest-labs/flux-video-upscale', 'input_references': '${ACTUAL_OWNED_INPUT_REFERENCES}', 'upscale_factor': '${ACTUAL_UPSCALE_FACTOR}', 'creativity': '${ACTUAL_CREATIVITY}'}
request['input_references']=json.loads(os.environ['AILOOT_INPUT_REFERENCES_JSON'])
request['upscale_factor']=float(os.environ['AILOOT_UPSCALE_FACTOR'])
request['creativity']=int(os.environ['AILOOT_CREATIVITY'])
Path('request.json').write_text(json.dumps(request,ensure_ascii=False),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 response.bin
# Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.

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

Ailoot Ultra · فيديو

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

حفظ جميع الأصول المكتملة

GET · جلب جميع الأصول المكتملة

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"
export AILOOT_STATUS_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
from urllib.parse import urlsplit,urljoin
f=Path(os.environ["AILOOT_STATUS_FILE"])
if not f.is_file():raise SystemExit("Choose the actual completed status file")
r=json.loads(f.read_text())
if r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")
urls=[]
for x in r["data"]:
    if not isinstance(x,str) or "\n" in x or "\r" in x:raise SystemExit("Invalid asset path")
    u=urljoin("https://api.ailoot.ai",x)
    z=urlsplit(u)
    if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")
    urls.append(u)
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_REQUEST
index=0
while IFS= read -r asset_url; do
  curl --fail-with-body --silent --show-error "$asset_url" \
    -H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"
  index=$((index + 1))
done < asset-urls.txt

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

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

احتفظ بالاستجابة كاملة وبجميع الترويسات، وبكل مخرج فعلي، وبالمعرّفات الأصلية المُعادة، وبجميع حقول الاستخدام. استعد العملية الأصلية دون إرسال طلب الإنشاء مجددًا.

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

احتفظ بـX-Client-Request-ID وX-Ailoot-Task-Id وبالقيم الفعلية المُعادة للحقلين id/polling_url. تابع المهمة الأصلية؛ ولا ترسل طلب الإنشاء مرة أخرى.

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

الحقل	النوع
الحقل`id`	النوع
الحقل`status`	النوع
الحقل`data[]`	النوع
الحقل`outputs[]`	النوع

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

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

Ailoot Ultra black-forest-labs/flux-video-upscale

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

استخدم مسارات الطرائق المعروضة أعلاه.

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

black-forest-labs/flux-video-upscale

FAQ · Black Forest Labs: FLUX Video Upscale

ما المدخلات والنتائج المتاحة؟: POST /v1/videos · black-forest-labs/flux-video-upscale: text, image, audio, video → video
ما الحقول التي يستخدمها الطلب؟: POST /v1/videos · black-forest-labs/flux-video-upscale: model, input_references, upscale_factor, creativity
ما الحدود المطبقة؟: POST /v1/videos · black-forest-labs/flux-video-upscale: upscale_factor.minimum: 1.5; upscale_factor.maximum: 3

Black Forest Labs: FLUX Video Upscale