Runway: Aleph 2.0
Aleph 2.0 עורך וידאו קיים באמצעות הוראות טקסט ממוקדות והנחיה בפריימי מפתח. השתמשו בו להחלפת חפץ, לשינוי רקע, לבוש, תאורה או סגנון, תוך הנחיה אילו מפרטי הסצנה המקורית צריכים להישאר שלמים.
על המודל
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
Aleph 2.0 הוא מודל עריכת הווידאו בתוך הקשר של Runway. הוא משנה חומר מצולם מסורתי או שנוצר, באמצעות הוראה כתובה והנחיית פריימי מפתח אופציונלית. התהליך המיועד שלו משנה את החלק המבוקש בסצנה תוך שימור הקומפוזיציה, התאורה והפרטים שסביבו, ולכן הוא מועיל להחלפת מוצר, לשינוי לבוש, לשינוי רקע, לתאורה מחדש או לשינוי סגנון חזותי בלי ליצור מחדש את הסצנה כולה מבריף טקסטואלי.
התחילו בפעולה ישירה ובשינוי הרצוי: הוספה, הסרה, החלפה, שינוי, תאורה מחדש או שינוי סגנון. בהחלפת מוצר, זהו את החפץ הנראה ותארו את מחליפו, ואז ציינו איזו תנועת יד, תנועת מצלמה וסביבה צריכות להישאר. בסצנה עונתית, תארו את מזג האוויר או האור שצריכים להשתנות. הוראה תמציתית וממוקדת נותנת יעד עריכה ברור יותר מבקשה כללית לשפר את הקטע כולו.
הנחיית פריימי מפתח קובעת כיצד התוצאה הערוכה צריכה להיראות ברגע מסוים. בחרו פריים המציג את המטרה בבירור: מבט רחב לשינוי רקע, או מבט קרוב יותר לתכונה קטנה או לאביזר. בתהליך Edit Studio של Runway, אפשר להציג ולשפר עריכת תמונת סטילס לפני שהגרסה הנבחרת מנחה את שינוי הווידאו. השוו את הפריים הערוך למקור מבחינת פרטי הנושא, קצוות וחפצים שברצונכם לשמר, ואז השתמשו בו ככיוון החזותי לקטע.
ה־API של היצרן תומך בסרטוני מקור של 2 עד 30 שניות ובעד חמש תמונות פריימי מפתח אופציונליות המוצבות בחותמות זמן שנקבעו. שמרו על הקישור בין כל תמונה מנחה לנקודה המיועדת שלה במקור, והשתמשו במספר קטן של שינויים ברורים במקום אוסף של יעדים חזותיים מתנגשים. Aleph 2.0 נפרד ממודל Gen-4 Aleph הישן יותר; היצרן מזהה בנפרד את מודל ה־API שלו. עריכה מונחית פריימי מפתח שונה גם מבקשה ממודל טקסט־לווידאו ליצור שוט בלתי קשור.
כללי ההכנה המתועדים של Edit Studio משתמשים ביחסי ממדים מקובלים, ברזולוציית מקור שבין 480p ל־1080p וב־24–30 פריימים לשנייה, עם לא יותר מעשרה חיתוכים או חילופי שוטים. הוא ממליץ על חומר מקור ב־720p או 1080p; חומר מעל 30 fps נדגם מחדש לקצב נמוך יותר, והעלאות מעל 30 שניות נחתכות בממשק ההוא. אלו כללי ההכנה של תהליך העריכה של היצרן. בחרו מקטע מקור המציג את האירוע השלם שברצונכם לערוך, ושהנושא בו נשאר נראה במקום שבו השינוי חייב להימשך.
המודל יכול להפיץ רקע, לבוש, חפץ, אור או סגנון ששונו לאורך החומר. הוראת תנועה נוספת שימושית כאשר העריכה זקוקה לפעולה חדשה שאינה קיימת במקור ושלא תנבע מפריים המפתח בלבד, כגון אפקט חזותי המתפתח עם הזמן. עריכות רבות אינן זקוקות לבריף תנועה נוסף משום שהמודל מנפיש את התאמת פריים המפתח בתוך הסצנה הקיימת. תארו תנועה חדשה במדויק ושמרו אותה נפרדת מהשינוי החזותי שפריים המפתח כבר קובע.
תהליך העריכה של היצרן מחיל עריכה על הסרטון המלא כברירת מחדל, ויכול להגביל אותה לטווח נבחר בציר הזמן. שמרו את הקטע המקורי כדי להשוות את התוצאה שנבחרה למקור ולהשתמש בה להמשך ממוקד. בדיקה מעשית מסתכלת מעבר לפריים שנבחר: בדקו התחלה, אמצע, סוף, כל חיתוך ואת התקופה שבה המטרה מוסתרת לזמן קצר. התוצר השימושי הוא קטע מתוקן שהשינוי שהתבקש בו נשאר עקבי לאורך הזמן, בעוד המרכיבים החשובים שלא שונו שומרים על תפקידם.
MP4 הוא תוצר ברירת המחדל להשמעה ולשיתוף. תהליך Edit Studio לסרטון מלא, כאשר הוא מתאים לכך אצל Runway, מציע גם ProRes כקובץ MOV עם שמע PCM, או ZIP של פריימי PNG בודדים לקומפוזיטינג. פרופילי ProRes נעים מ־422 Proxy עד 4444 XQ. עריכות המוגבלות לטווח בציר הזמן מחזירות MP4, ופורמט הפלט נבחר בתחילת היצירה ולא משתנה לאחר התוצאה המוגמרת. בחרו את צורת הייצוא של היצרן למשימת העריכה הבאה, תוך הפרדתה מיכולת העריכה החזותית המרכזית של המודל.
לעריכה מוגמרת שימושית, השוו את ההחלפה, התאורה או הסגנון המיועדים לפריים המפתח ובדקו את הפרטים שסביבם שלא נועדו להשתנות. שמרו את הגרסה המוצלחת ותקנו את ההוראה או את הפריים המנחה המסוימים האחראים לאי־התאמה. תפקיד Aleph 2.0 הוא שינוי חומר מקור באמצעות יעד חזותי ברור; הפקת פסקול חדש, שינוי התנהגות יישום או השלמת צינור מסירה נפרד לשידור הם משימות נוספות סביב הסרטון הערוך.
Ailoot Ultra · וידאו POST /v1/videos runway/aleph-2
runway/aleph-2התחלה
Aleph 2.0 עורך וידאו קיים באמצעות הוראות טקסט ממוקדות והנחיה בפריימי מפתח. השתמשו בו להחלפת חפץ, לשינוי רקע, לבוש, תאורה או סגנון, תוך הנחיה אילו מפרטי הסצנה המקורית צריכים להישאר שלמים.
- סוגי קלט נתמכים
- טקסט · תמונות · שמע · וידאו
- תוצאות
- וידאו
זמין ב-Ailoot · קלט ושיטות
Ailoot Ultra · וידאו POST /v1/videos
- סוגי קלט
text,image,audio,video- סוגי פלט
video
| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות runway/aleph-2 | ברירת מחדל— |
שדה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.56 לכל שניית וידאו |
| תצורהחיוב מינימלי ליצירה | טבלת תעריפים— | כמות חזויה— | רכיב חיובחיוב מזערי | יחידת חיובחיוב יצירה מזערי | תנאי חיובלא הוגדר תנאי נוסף במפתח תמחור זה. | כלל חיוב מזעריכן | חיוב total · מינימום ליצירה · אומדן להשוואה בלבד $1.12 חיוב יצירה מזערי חיוב מינימלי לכל יצירה; יש להחיל אותו כמינימום ולא כעמלה נוספת. אין בכך כדי לרמוז על משך מינימלי. |
| תצורהעלות יצירה משוערת | טבלת תעריפים— | כמות חזויהאומדן ליצירה אחת | רכיב חיוב— | יחידת חיוב— | תנאי חיוב— | כלל חיוב מזערי— | חיוב פלט · עלות יצירה משוערת · אומדן להשוואה בלבד $0.56 אומדן לפני היצירה אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה. |
לפני הבקשה 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': 'runway/aleph-2', '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 runway/aleph-2
כינויים לנתיבי שיטות
השתמשו בנתיבי השיטות המוצגים למעלה.
מזהי מודלים קשורים IDs
FAQ · Runway: Aleph 2.0
- אילו קלטים ותוצאות זמינים?
POST /v1/videos·runway/aleph-2:text,image,audio,video→video- באילו שדות הבקשה משתמשת?
POST /v1/videos·runway/aleph-2:model,input_references,prompt