Black Forest Labs: FLUX Video Edit
FLUX Video Edit [fast] משנה קטע קיים באמצעות הוראת עריכה כתובה. הוסיפו, הסירו או החליפו מרכיבים, שנו סביבה או סגנון ועדכנו דיאלוג קיים תוך עמידה באילוצי אורך המקור, המסגור והשמע המתועדים.
על המודל
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
FLUX Video Edit [fast] הוא תהליך מונחה ההנחיות של Black Forest Labs לשינוי סרטון קיים. הוא מקבל קטע מקור אחד והוראה המתארת את העריכה, ומחזיר MP4 ערוך. המקור קובע את השוט: משכו, מסגורו, תנועת המצלמה והתזמון שלו מספקים את המבנה ההתחלתי. השתמשו בהנחיה כדי לזהות מה צריך להשתנות, במקום לכתוב תיאור של סצנה חדשה לגמרי שמשאיר את השינוי המיועד לא ברור.
ציון השינוי ומיקומו
העריכות המתועדות כוללות הסרה, הוספה או החלפה של חפצים ודמויות, בנייה מחדש של הסביבה, שינוי סגנון קטע, שינוי טקסט נראה ועדכון דיאלוג או צליל. התחילו במטרה ובפעולה. הוראה מקורית יכולה להסיר תיק מכיסא תוך שימור האדם היושב והחדר, או להחליף ספל פשוט בספל אמייל כחול בלי לשנות את פעולת היד. אם נראים כמה חפצים דומים, הבדילו את המטרה באמצעות מיקום, מראה או תפקיד.
בהוספה, תארו מיקום, קנה מידה ופעולה רלוונטית. מנורה אדומה גבוהה לצד הספה מדויקת יותר ממנורה נוספת לא מוגדרת במקום כלשהו בשוט. בהחלפה, זהו מה הופך למה ואיזו תנועה או איזה מגע צריכים להישאר. מדריך ההנחיות של היצרן ממליץ על ההוראה הקצרה ביותר שמגדירה את השינוי במלואו, והוספת פרטים במקומות שהעריכה דורשת. שמרו על מאפייני המקור במכוון במקום לבקש שיפור כללי שאין דרך להעריך את היקפו.
סביבות, סגנונות ואנימציה גסה
שינוי סביבה יכול לבנות מחדש את הסביבה הנראית תוך שימור הפעולה. היצרן מדגים החלפת משטח טיפוס במבנה אחר וציון נקודות המגע החדשות, כך שלידיים ולרגליים של הדמות עדיין יש משטח בעל משמעות. בסצנה מעשית, תארו את הסביבה ששונתה ואת הגאומטריה שהתנועה הקיימת נשענת עליה. רקע חדש קל יותר להערכה כאשר לפעולה המקורית יש קשר מפורש אליו.
המדריך מציג גם הפיכת אנימציה גסה לטיפול חזותי מוגמר. ציינו אילו אובייקטים בסיסיים בהדמיה הראשונית הופכים לכלי הרכב או האביזרים המיועדים, ואז שמרו על מסלוליהם, מהירויותיהם ויחסם למצלמה. בשינוי סגנון, תארו את החומרים, המשטחים, האור וההשתקפויות המתקבלים וגם את האסתטיקה. סצנה דמוית חימר וסצנה בעלת מראה צילומי דורשות רמזים נראים שונים גם כאשר הן עוקבות אחר אותה פעולה.
שינוי נוסף יכול להשתמש בתוצאת העריכה הראשונה כמקור חדש. שמרו את המקור וכל שלב שנבחר, ותנו למעבר הבא מטרה ברורה אחת. הדוגמה המתועדת מלווה תצוגה גסה דרך סביבה מוגמרת ואז טיפול תאורה נוסף. אחרי כל מעבר, השוו את הקטע ששונה למקור הקודם ובדקו שהמאפיינים שהתכוונתם לשמר עדיין קיימים.
דיאלוג חייב להתאים לזמן הקיים
התהליך מעביר את שמע המקור אלא אם ההוראה מבקשת שינוי דיאלוג או צליל. מקור אילם מחזיר תוצאה אילמת, ולכן אינו מספק דיבור קיים לעדכון. בעריכת דיאלוג, צטטו את השורה המיועדת, זהו את הדובר והתאימו את המילים החדשות לזמן שתופסת שורת המקור. המדריך מדווח על החלפה ארוכה יותר שנחתכה כאשר חרגה ממרווח הדיבור הזמין. כתיבת מילים נוספות אינה יוצרת זמן דיבור נוסף בשוט הקיים.
בדקו את השורה הנשמעת לצד הביצוע החזותי. שמרו עותק של נוסח המקור ושל ההחלפה המיועדת כדי שאפשר יהיה לזהות מילה שהושמטה, ביטוי בתזמון שגוי או שינוי צליל בלתי רצוי. התוצאה השימושית היא הרגע המדובר המעודכן בתוך הסצנה הערוכה, ולא הנחה לתמליל נאמן רק משום שהרינדור הסתיים.
מגבלות מקור ופלט שעובר בירושה
פרופיל היצרן המדויק דורש סרטון והנחיית עריכה. ההוראה היא באורך תו אחד עד 4,096 תווים לאחר הסרת רווחים חיצוניים. הקטע מסופק באמצעות כתובת או MP4 מקודד, באורך מרבי של חמש עשרה שניות ובמגבלת קלט של חמישים MiB. כל צלע חייבת להיות לפחות 160 פיקסלים, והקטע המנורמל חייב להכיל לפחות שבעה עשר פריימים ב־24 fps, בערך שבע עשיריות שנייה. מקורות ארוכים מדי נדחים במקום להיחתך בשקט; מקורות קטנים מדי יכולים להיכשל במהלך העיבוד.
התהליך המתועד משתמש בעיבוד של 24 fps ועוקב אחר אורך המקור ויחס הממדים שלו. קלטים מעל פרופיל 720p מוקטנים; היצרן מציג מקור של 1920×1088 החוזר כ־1248×704. משך, רזולוציה ויחס ממדים אינם הגדרות פלט עצמאיות בפרופיל העריכה הזה. מתכון הדגימה שלו מטופל פנימית, ושדות כגון mode, version, seed או generate_audio אינם מתקבלים בחוזה הבקשה המוצהר.
סרטון המשמש רק כהשראת תנועה או סגנון לשוט חדש שנוצר שייך לתהליך אחר. עורך זה אינו מקבל תמונת ייחוס, קלט שמע בלבד, מסכות או בקשה להארכת הקטע. הכינו את הסרטון שאותו יש לשנות ושמרו על משך הקטע שנבחר לפני כתיבת העריכה. לאחר עיבוד אסינכרוני, היצרן מחזיר את ה־MP4 הערוך בקישור מסירה חתום זמני, התקף כשעה. שמרו את התוצאה והשוו את החפץ ששונה, הפריימים שסביבו, התזמון והשמע למקור לפני שילוב הקטע בעריכה ארוכה יותר.
Ailoot Ultra · וידאו POST /v1/videos black-forest-labs/flux-video-edit
black-forest-labs/flux-video-edit
black-forest-labs/flux-video-editהתחלה
FLUX Video Edit [fast] משנה קטע קיים באמצעות הוראת עריכה כתובה. הוסיפו, הסירו או החליפו מרכיבים, שנו סביבה או סגנון ועדכנו דיאלוג קיים תוך עמידה באילוצי אורך המקור, המסגור והשמע המתועדים.
- סוגי קלט נתמכים
- טקסט · תמונות · שמע · וידאו
- תוצאות
- וידאו
זמין ב-Ailoot · קלט ושיטות
Ailoot Ultra · וידאו POST /v1/videos
- סוגי קלט
text,image,audio,video- סוגי פלט
video
| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות black-forest-labs/flux-video-edit | ברירת מחדל— |
שדהinput_references | סוגarray | דרישהחובה | ערכים ומגבלות מספר פריטים מזערי: 1 מספר פריטים מרבי: 1 | ברירת מחדל— |
שדהprompt | סוגstring | דרישהחובה | ערכים ומגבלות אורך מזערי: 1 | ברירת מחדל— |
פרמטרים ומחזור חיים של השיטה
| פרמטר | מפרט |
|---|---|
פרמטרcontent_type | מפרטapplication/json |
פרמטרrequired | מפרטmodel, input_references, prompt |
פרמטר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 טוקנים |
| תצורהמחיר וידאו | טבלת תעריפים— | כמות חזויה— | יחידת חיובלכל שניית וידאו | תנאי חיובלא הוגדר תנאי נוסף במפתח תמחור זה. | חיוב פלט · מחיר וידאו · אומדן להשוואה בלבד $0.06 לכל שניית וידאו |
| תצורהעלות יצירה משוערת | טבלת תעריפים— | כמות חזויהאומדן ליצירה אחת | יחידת חיוב— | תנאי חיוב— | חיוב פלט · עלות יצירה משוערת · אומדן להשוואה בלבד $0.06 אומדן לפני היצירה אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה. |
לפני הבקשה 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_PROMPT:?Set the actual documented input value}"
export AILOOT_PROMPT
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
request={'model': 'black-forest-labs/flux-video-edit', 'input_references': '${ACTUAL_OWNED_INPUT_REFERENCES}', 'prompt': '${ACTUAL_EDIT_PROMPT}'}
request['input_references']=json.loads(os.environ['AILOOT_INPUT_REFERENCES_JSON'])
request['prompt']=os.environ['AILOOT_PROMPT']
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
שמירת כל הנכסים שהושלמו
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-edit
כינויים לנתיבי שיטות
השתמשו בנתיבי השיטות המוצגים למעלה.
מזהי מודלים קשורים IDs
FAQ · Black Forest Labs: FLUX Video Edit
- אילו קלטים ותוצאות זמינים?
POST /v1/videos·black-forest-labs/flux-video-edit:text,image,audio,video→video- באילו שדות הבקשה משתמשת?
POST /v1/videos·black-forest-labs/flux-video-edit:model,input_references,prompt