Alibaba: Wan 2.7
Alibaba Wan 2.7 יוצר סרטונים עם קול מטקסט, מתמונות פתיחה וסיום או ממקורות חזותיים. תהליך העבודה שלו עם תמונות גם ממשיך קליפ מקור, לפי משך הזמן הכולל המבוקש. היצרן מציין MP4 ברזולוציית 720p או 1080p ובקצב 30 fps: משך של 2–15 שניות במצבי טקסט/תמונה ועד 10 שניות ביצירה לפי מקורות ייחוס.
על המודל
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
Alibaba Wan 2.7 הוא משפחת מודלים ליצירת וידאו עם פרופילים מוגדרים ליצירה מטקסט, ליצירה מתמונה וליצירה בהנחיית ייחוסים. היצרן מתעד סצנות עם אודיו מסונכרן וסיפורים מרובי שוטים, ותהליך העבודה מתמונות מוסיף יצירה מפריים ראשון ואחרון והמשך של סרטון התחלתי. התוצאה השימושית היא קליפ קצר עם הקול שלו, כגון מעבר מוצר, סיפור תמציתי או המשך שמתאים לשוט קיים. בחרו את המצב לפי חומר המקור ולפי השליטה הדרושה בפתיחה או בסיום.
ליצירה מטקסט לווידאו, תארו את הנושא, הסביבה, הפעולה, המצלמה, הסגנון והקול. לוח סיפור יכול לזהות כל שוט וטווח זמן, ואילו בריף לשוט בודד צריך לציין שהפעולה נשארת רציפה. מדריך ההנחיות של Wan 2.7 מאפשר למודל לפרש את מבנה השוטים מתוך הבריף הכתוב, במקום להשתמש בבקרת shot_type של 2.6. ממשק ה־API הנוכחי לטקסט מקבל הנחיות בסינית או באנגלית באורך של עד 5,000 תווים, עם הנחיה שלילית נפרדת באורך 500 תווים; טקסט עודף נקטע. הגדירו בבירור את הפעולה והמגבלות החיוניות בתוך המסגרת הזו.
יצירת וידאו מתמונת פריים ראשון מנפישה תמונת פתיחה שסופקה. יצירה מפריים ראשון ואחרון מגדירה גם את נקודת הסיום ואת התנועה המחברת אליה. מדריך התמונה של 2.7 תומך במקור אודיו מניע לצד שילובי הפריימים האלה. הכינו נקודות קצה שחולקות סצנה ונושא מכוון, ותארו את המעבר במקום לבקש מהמודל לפרש מחדש את שתי התמונות כייחוסי סגנון שאינם קשורים. הפלט מתקרב ליחסי הממדים של התמונה הראשונה; המדריך מתייחס לרזולוציה כדרגת מספר פיקסלים ומעגל בהתאם את הממדים המקודדים.
המשכת וידאו מתחילה בקליפ מקור ויכולה להשתמש גם בתמונת סיום. המשך המבוקש הוא משך הסרטון הכולל שיוחזר, לרבות הקטע המקורי. דוגמת המדריך משלבת מקור באורך שתי שניות עם עשר שניות של תוכן חדש לתוצאה באורך שתים עשרה שניות. הכינו את הפעולה הסופית של המקור וציינו מה קורה בהמשך, כדי שהמצלמה והנושא ימשיכו בכיוון מגובש. בדקו בנקודת החיבור מראה, תנועה, אור וקול במקום להעריך רק את הסיום החדש שנוצר.
פרופיל הייחוסים הנפרד והנוכחי של היצרן משתמש בתמונות או בווידאו כדי להנחות דמויות, עצמים או סצנה. המדריך שלו מאפשר עד חמישה פריטי ייחוס בסך הכול, תמונות וסרטונים, ומשתמש בתוויות לפי סוג, כגון Image 1 ו־Video 1. תארו את תפקידו של כל חומר ואת האינטראקציה הרצויה. לסצנה בהנחיית ייחוסים, הציגו דמות מייחוס אחד הנושאת את העצם מייחוס אחר דרך מיקום מוגדר. מסגור מייחוסים שונה מיצירה מפריים ראשון: הבריף יכול לקבוע קומפוזיציה חדשה במקום לחייב את הסרטון להיפתח בתמונת סטילס מסוימת שסופקה.
לאודיו מותאם אישית ביצירה מטקסט, הפורמטים המתועדים הם WAV ו־MP3, באורך שתיים עד שלושים שניות ובגודל מרבי של 15 MB. משך הווידאו שנבחר קובע באיזה חלק ייעשה שימוש: אודיו ארוך יותר נחתך לאורך הזה, ואודיו קצר מהווידאו משאיר את יתרתו שקטה. הכינו את קטע האודיו המדויק ששייך לשוט והשאירו מקום לפעולה החזותית הרצויה. ללא קובץ אודיו שסופק, היצרן מתאר יצירת מוזיקת רקע או אפקטים שמתאימים לסצנה; בדקו את הקול בפועל וכל דיבור שהתבקש יחד עם התמונה.
מטריצת המודלים הנוכחית מציינת MP4 ב־720p או 1080p בקצב 30 פריימים לשנייה, עם פלט באורך שתיים עד חמש עשרה שניות ליצירה מטקסט ומתמונה. פרופיל הייחוסים הנפרד מוגבל לשתיים עד עשר שניות. יצירה מטקסט מציעה מסגור ביחסים 16:9, 9:16, 1:1, 4:3 ו־3:4. משימות המותנות בתמונה משתמשות בכללים משלהן לקירוב יחס הממדים של המקור, לכן הכינו את חיתוך הקלט ליעד הרצוי. אין להחליף את כללי המשך או יחס הממדים של תהליך הפריימים או ההמשכה בכללים מפרופיל הייחוסים.
התהליך המתועד של היצרן הוא אסינכרוני: מזהה משימה עוקב אחר העיבוד, ותוצאה מוצלחת מספקת את מיקום הווידאו. לתוצאות מתועד תוקף קישור של עשרים וארבע שעות, לכן שמרו את הקליפ עצמו ואת החומרים היצירתיים לצורך בדיקת העריכה. אפשרויות שכתוב ההנחיה, סימן המים וערך ה־seed שייכות לממשק שנבחר. היצרן אומר שערך seed קבוע יכול לשפר שחזור, אך אינו מבטיח תוצאה זהה. השוו את התוצר שהוחזר לבריף במקום להניח שההגדרות לבדן משמרות כל פרט.
בהשוואה ל־Wan 2.6, מדריך התמונה של 2.7 מוסיף במפורש שליטה בפריים ראשון ואחרון והמשכת וידאו באמצעות קלטי מדיה רב־מודאליים. Wan 3.0 מציג מבנה משולב אחר ומסגרת יצירה ארוכה יותר. פרופיל 2.7 הזה שומר על הבקרות והמגבלות הייעודיות שלו לכל משימה. בדקו את הסצנה כולה מבחינת רציפות הנושא, עוגני הפריימים, זהות הייחוסים, הדיאלוג, התנועה והחיבורים, והגדירו תיקון ממוקד בהתאם לבעיה שנמצאה בפועל.
Ailoot Ultra · וידאו POST /v1/videos alibaba/wan-2.7
alibaba/wan-2.7התחלה
Alibaba Wan 2.7 יוצר סרטונים עם קול מטקסט, מתמונות פתיחה וסיום או ממקורות חזותיים. תהליך העבודה שלו עם תמונות גם ממשיך קליפ מקור, לפי משך הזמן הכולל המבוקש. היצרן מציין MP4 ברזולוציית 720p או 1080p ובקצב 30 fps: משך של 2–15 שניות במצבי טקסט/תמונה ועד 10 שניות ביצירה לפי מקורות ייחוס.
- סוגי קלט נתמכים
- טקסט
- תוצאות
- וידאו
זמין ב-Ailoot · קלט ושיטות
Ailoot Ultra · וידאו POST /v1/videos
- סוגי קלט
text- סוגי פלט
video- פורמט פלט
- mp4
- מספר פלטים
- עד 4 פלטs
| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות alibaba/wan-2.7 | ברירת מחדל— |
שדהprompt | סוגstring | דרישהחובה | ערכים ומגבלות מספר בייטים מרבי ב-UTF-8: 10,000 נדרשים תווים שאינם רווחים: כן | ברירת מחדל— |
שדהduration | סוגinteger | דרישהחובה | ערכים ומגבלות 2, 3, 4, 5, 6, 7, 8, 9, 10 | ברירת מחדל— |
שדהresolution | סוגstring | דרישהחובה | ערכים ומגבלות 720p | ברירת מחדל— |
שדהaspect_ratio | סוגstring | דרישהחובה | ערכים ומגבלות 16:9, 9:16, 1:1, 4:3, 3:4 | ברירת מחדל— |
שדהgenerate_audio | סוגboolean | דרישהחובה | ערכים ומגבלות false, true | ברירת מחדל— |
שילובים של חומרי קלט
מטקסט לווידאו · נדרש: prompt
פרמטרים ומחזור חיים של השיטה
| פרמטר | מפרט |
|---|---|
פרמטרcontent_type | מפרטapplication/json |
פרמטרrequired | מפרטmodel, prompt, duration, resolution, aspect_ratio, generate_audio |
פרמטרadditional_properties | מפרטfalse |
פרמטרparameters | מפרט{"name":"model","type":"string","required":true,"enum":["alibaba/wan-2.7"]}, {"name":"prompt","type":"string","required":true,"non_whitespace":true,"max_utf8_bytes":10000}, {"name":"duration","type":"integer","required":true,"enum":[2,3,4,5,6,7,8,9,10]}, {"name":"resolution","type":"string","required":true,"enum":["720p"]}, {"name":"aspect_ratio","type":"string","required":true,"enum":["16:9","9:16","1:1","4:3","3:4"]}, {"name":"generate_audio","type":"boolean","required":true,"enum":[false,true]} |
פרמטרmaterial_types | מפרטtext |
כינויים לשיטה: /v1/videos/generations, /videos, /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
יש לשמור את התגובה המלאה ואת המזהים המקוריים שהוחזרו.
אין לשלוח שוב בקשת יצירה שמצבה אינו ידוע.
תעריפים
אופן חישוב החיוב הסופי
התעריפים המוצגים מספקים אומדן לעלות לפני היצירה. החיוב הסופי מחושב לפי העלות שנרשמה עבור היצירה המקורית. משך הפלט שנמדד והכמויות החזויות אינם הכמות הסופית לחיוב.
מידע תעריפים אינו מוסיף אפשרויות לבקשה. הפרמטרים הנתמכים מפורטים בשיטה שנבחרה.
- מצב מהיר
- לא צוין כאשר נבחר מצב מהיר
- מצב Flex
- לא צוין כאשר נבחר מצב flex
- מאמץ חשיבה מרבי
- לא צוין כאשר מאמץ החשיבה המרבי משתמש בהתאמת ברירת המחדל (default)
תעריפים משוערים להשוואה
מחירים לפי תצורה
התאימו כל חיוב לתנאים המוצגים. השתמשו בתעריף אחד לכל קבוצה של תצורות חלופיות.
| תצורה | טבלת תעריפים | כמות חזויה | אפשרויות ליצירת שמע | רזולוציה | יחידת חיוב | חיוב |
|---|---|---|---|---|---|---|
| תצורהתעריפי בסיס לטוקנים | טבלת תעריפיםתעריף בסיס | כמות חזויה— | אפשרויות ליצירת שמע— | רזולוציה— | יחידת חיוב— | חיוב קלט · טוקני קלט · אומדן להשוואה בלבד — / 1K טוקנים פלט · טוקני פלט · אומדן להשוואה בלבד — / 1K טוקנים קלט · קריאה מהמטמון · אומדן להשוואה בלבד — / 1K טוקנים קלט · כתיבה למטמון · אומדן להשוואה בלבד — / 1K טוקנים קלט · כתיבה למטמון, 1 שעה · אומדן להשוואה בלבד — / 1K טוקנים |
| תצורהUltra | טבלת תעריפים— | כמות חזויהההגדרות המבוקשות; אומדן בלבד. | אפשרויות ליצירת שמעללא שמע · עם שמע | רזולוציה720p | יחידת חיובלכל שניית וידאו בפלט | חיוב פלט · שניית וידאו משוערת · אומדן להשוואה בלבד $0.2 לכל שניית וידאו בפלט התעריף המוצג אומד את העלות לפני היצירה. החיוב הסופי מחושב מהעלות שנרשמה ליצירה המקורית. משך הווידאו הפיזי אינו הכמות לחיוב. |
| תצורהעלות יצירה משוערת | טבלת תעריפים— | כמות חזויהאומדן ליצירה אחת | אפשרויות ליצירת שמע— | רזולוציה— | יחידת חיוב— | חיוב פלט · עלות יצירה משוערת · אומדן להשוואה בלבד $0.4 אומדן לפני היצירה אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה. |
לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →
פרטי תעריף הייחוס
טבלאות הייחוס ברמת המודל אינן משנות את בחירת השיטה, הצעות המחיר או החיובים. החיובים בפועל משתמשים בתעריפי שיטת Ailoot שנבחרה.
הפניות למחירי תצורות וידאו
מחירים לפי תצורה
| תצורה | תנאי חיוב | חיוב |
|---|---|---|
| תצורהמחיר וידאו | תנאי חיובלא הוגדר תנאי נוסף במפתח תמחור זה. | חיוב פלט · מחיר וידאו $0.2 לכל שניית וידאו מחיר הייחוס שפורסם עבור התצורה המוצגת. החיובים הסופיים נקבעים לפי התצורה שחויבה בפועל. |
דוגמאות לבקשות
Ailoot Ultra · וידאו
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "alibaba/wan-2.7", "prompt": "a calm greenhouse", "duration": 6, "resolution": "720p", "aspect_ratio": "16:9", "generate_audio": true}')
Path('request.json').write_text(json.dumps(p,ensure_ascii=False))
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 result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
קבלה ושמירה של תוצאות
Ailoot Ultra · וידאו
mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
בדיקת מצב המשימה
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
קריאות תוכן נוספות
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
שמירת כל התוצאות שהושלמו
שמרו כל וידאו שהושלם או קובץ שהוחזר; אחזרו כל נכס מכל URL שהוחזר בפועל.
יש לשמור כל כתובת URL חתומה ובבעלותכם מתוך data[] שהושלם ואת מטא־נתוני הסטטוס המלאים. יש לשמור כל פלט, כולל האודיו שנוצר בו. רצועת אודיו תקפה של AAC עשויה להיכלל גם כאשר generate_audio=false; יש לשמור את קובץ ה־MP4 המקורי במלואו, כולל האודיו הזה.
כשצריך לבדוק את התגובה המקורית
יש לקרוא את המשימה המקורית הקיימת; אין לשלוח שוב בקשה שתוצאת שליחתה אינה ידועה.
מספר פלטים מרבי: 4.
שדות התגובה
| שדה | סוג | משמעות |
|---|---|---|
שדהid | סוגstring | משמעות— |
שדהobject | סוגstring | משמעות— |
שדהmodel | סוגstring | משמעות— |
שדהstatus | סוגstring | משמעות— |
שדהdata[] | סוגsigned content URL | משמעות— |
שדהcharge_pending_check | סוגboolean | משמעות— |
שדהerror.code | סוגstring | משמעות— |
שדהerror.message | סוגstring | משמעות— |
שדהoperation_id | סוגstring | משמעותתגובת HTTP503 result_pending_check לסטטוס או לתוכן המקוריים: אותו מזהה ציבורי מקורי של פעולת הווידאו בשדה id. |
שדהerror.type | סוגstring | משמעותserver_error בתגובת HTTP503 result_pending_check. |
שגיאות והשלבים הבאים
| תגובה | תנאי | השלב הבא |
|---|---|---|
תגובה400 · invalid_request_error | תנאיקריאת גוף הבקשה הגולמי נכשלת לפני פענוח פרופיל הווידאו | השלב הבאיש לשמור את התגובה שהוחזרה ולתקן את גוף הבקשה שלא ניתן לקרוא. |
תגובה422 · price_unavailable | תנאיפענוח פרופיל הווידאו המדויק נכשל, או שלפרופיל המלא שפוענח אין כרטיס מחיר מדויק ומוכן | השלב הבאיש לשמור את התגובה; יש להשתמש בפרופיל המלא והמדויק שאושר ובכרטיס המחיר שפורסם עבורו. הענף הזה מתבצע לפני שליחה לספק. |
תגובה409 · video_not_ready | תנאיתוכן התוצאה המקורית עדיין אינו זמין | השלב הבאיש לבדוק במחזוריות את המזהה המקורי שהוחזר ולכבד את Retry-After. |
תגובהserver_error | תנאיהתשובה שהוחזרה מציינת שהפעולה או התוצאה דורשת בדיקה | השלב הבאשמרו את מזהה הפעולה/המשימה המקורי שהוחזר, את כותרות הבקשה ואת התשובה; המשיכו לבצע פעולות קריאה נתמכות של אותה פעולה מקורית. אל תשלחו שוב את בקשת היצירה. |
תגובה503 · result_pending_check | תנאיGET לסטטוס או לתוכן המקוריים: המשימה אינה מפורסמת, המשימה המקורית אינה במצב failed/cancelled/expired, והמצב המקומי הוא unknown או שסטטוס המשימה המקורית הוא completed. | השלב הבאיש לשמור את id ואת operation_id המקוריים (אותו מזהה וידאו ציבורי), את התגובה ואת הכותרות; יש לקרוא רק את הסטטוס והתוכן המקוריים. אין לשלוח בקשת יצירה חדשה. |
כינויים
כינויים למודל
Ailoot Ultra alibaba/wan-2.7
כינויים לנתיבי שיטות
/v1/videos/generations, /videos, /videos/generations
מזהי מודלים קשורים IDs
FAQ · Alibaba: Wan 2.7
- אילו קלטים ותוצאות זמינים?
POST /v1/videos·alibaba/wan-2.7:text→video- באילו שדות הבקשה משתמשת?
POST /v1/videos·alibaba/wan-2.7:model,prompt,duration,resolution,aspect_ratio,generate_audio