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. קטע מסופק באמצעות כתובת וידאו או MP4 מקודד. התיעוד המדויק מציין שהעיבוד מכסה את עשרים השניות הראשונות: חריגה קטנה באורך יכולה להיות מעובדת רק עד נקודה זו, ואילו קטע ארוך במידה ניכרת נדחה. לא מפורסמת סבילות מספרית. חתכו למקטע המיועד באורך עשרים שניות או פחות במקום להסתמך על התנהגות גבול לא מוגדרת.

בחרו בגרסה הדחוסה פחות הזמינה. ארטיפקטי דחיסה מגבילים את כמות הפרטים האמיתיים שהמגדיל יכול לשחזר, ושיפור יצירתי יכול ליצור טקסטורה סבירה בלי לבסס מה הכילה הסצנה המקורית. השלימו את העריכה והחיתוך המיועדים לפני הגדלת הקטע שנבחר. תהליך מקורי יכול תחילה לסיים שוט מוצר, לבחור את מרווח הפעולה השימושי ואז להגדיל את הבחירה הסופית, תוך שימור המקור ללא שינוי להשוואה.

התוצאה שומרת על רצועת שמע המקור. בדקו את תזמונה עם התמונה, במיוחד בתחילת מקטע שנבחר ובסופו. הפרופיל המתועד אינו מספק בורר קצב פריימים עצמאי, יצירת דיאלוג חדש או בקרות עריכה באמצעות תמונת ייחוס. מטרתו היא וידאו גדול יותר וטיפול נבחר בפרטים, עם שימור חומר הזמן והצליל של המקור בתוך המקטע המעובד.

שמירת הקטע שנמסר ובדיקתו

תהליך היצרן אסינכרוני: משימה שנשלחת מספקת זהות ומיקום סטטוס, והתוצאה שהושלמה מכילה קישור MP4 חתום למסירה. הקישור פג לאחר כשעה. שמרו את הקטע עצמו, את המקור, את המקדם שנבחר, את מצב היצירתיות ואת תיאור התוכן במקום להסתמך על המיקום הזמני. הבחינו בין סטטוס כישלון או מודרציה לבין סרטון שהושלם.

בדקו פריימים בודדים לפנים, סימונים ושינויי משטחים, ואז צפו ברצף לבחינת המשכיות, תנועה ויישור שמע. פלט מדויק ופלט יצירתי עונים לדרישות חזותיות שונות; התוצר השימושי הוא הקטע המוגדל שעומד ביעד הנאמנות שנבחר בגודל התצוגה המיועד. רזולוציה גבוהה יותר לבדה אינה ראיה לכך שהזהות, הנוסח או הפרטים העדינים המקוריים נשארו נכונים.

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: לא צוין כאשר נבחר מצב 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