MiniMax: I2V 01 Director
I2V 01 Director מנפיש תמונת פריים ראשון באמצעות פקודות מפורשות לתנועת מצלמה בפרומפט. שלבו את הקומפוזיציה שסופקה עם פקודות truck, pan, push, tilt, zoom, tracking או הוראות למצלמה סטטית, כדי לתכנן שוט קצר.
על המודל
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
I2V 01 Director הוא מהדורת התמונה-לווידאו של MiniMax עם פקודות מצלמה מתועדות. תמונה שסופקה מגדירה את הפריים הראשון, והפרומפט מנחה גם את הפעולה הנראית וגם את המצלמה. זה שימושי כשקומפוזיציה קיימת דורשת התקרבות, חשיפה, תנועת מעקב או מבט סטטי מבוקר מסוימים, ולא הנפשה לא מוגדרת.
הכינו את התמונה כפתיחת השוט המיועד. לחשיפה, הראו את הנושא ואת חלק הסביבה שהמצלמה צריכה לגלות. להתקרבות צמודה, התחילו עם מספיק מרחב מסביב כדי שהשינוי במסגור יהיה ברור. בדקו שהמאפיינים החשובים של הנושא גלויים לפני תחילת התנועה, במיוחד כשצורת מוצר או מראה דמות חייבים להישאר ניתנים לזיהוי.
היצרן מקבל תמונות ייחוס JPG, JPEG, PNG ו-WebP הקטנות מ-20 MB, עם צלע קצרה הגדולה מ-300 פיקסלים ויחס ממדים בין 2:5 ל-5:2. כתובת URL נגישה לתמונה או נתוני תמונה מקודדים יכולים לזהות את הפריים הראשון בתהליך העבודה של היצרן. שמרו את תמונת הייחוס המקורית, כדי שתיקון מאוחר יותר ישתמש באותה קומפוזיציה ולא בקירוב שנוצר מחדש.
הפרומפט תומך בעד 2,000 תווים וכולל חמש-עשרה פקודות מצלמה בעלות שם. Truck מזיזה את המצלמה אופקית, pan משנה את הכיוון האופקי שלה, pedestal מזיזה אותה אנכית ו-tilt משנה את הכיוון האנכי שלה. Push, pull ו-zoom מציעות סוגים שונים של התקרבות או התרחקות; tracking, shake ושוט סטטי מכסים כוונות מצלמה אחרות. השתמשו באיות המתועד של הפקודה כשמציינים תנועה.
מקמו פקודות בתוך סוגריים מרובעים בחלק התיאור שבו התנועה צריכה להתרחש. כמה פקודות בתוך אותם סוגריים מבקשות תנועה בו-זמנית, ואילו פקודות בנקודות עוקבות מתארות רצף. היצרן ממליץ על מקסימום של שלוש תנועות משולבות. תנועת push פשוטה לעבר נושא יכולה להציג פרט בצורה ברורה יותר מכמה תנועות שמתחרות על אותו שוט קצר.
תארו את תנועת הנושא בנפרד מתנועת המצלמה. אדם ההולך לעבר דלת ומצלמה העוקבת אחריו הם שתי הוראות עם השפעות חזותיות שונות. ציינו את הקשר הרצוי ביניהן, כגון שמירת הפנים גלויות במהלך ההתקרבות או החזקת המצלמה ללא תנועה כשהנושא חוצה את הפריים. זהו את הקומפוזיציה הסופית כדי שלפעולה שנוצרת יהיה יעד מועיל.
טבלת התמונה-לווידאו הוותיקה של היצרן מציינת 720P כברירת המחדל למהדורה הזאת ואינה מונה אפשרות של עשר שניות. מיטוב פרומפט אוטומטי מופעל כברירת מחדל, ואפשר להשבית אותו לשליטה הדוקה יותר בתיאור הכתוב. שמרו את ההגדרה שלו לצד תמונת המקור והוראות המצלמה כשמשווים שוטים, כדי ששינוי בניסוח או בפרשנות יהיה גלוי ברשומת היצירה.
בדקו את הקליפ השלם מבחינת מסלול המצלמה המבוקש, המשכיות הנושא ומסגור הפרטים החשובים. בדקו אם תנועת push או pan חושפת את המידע המיועד ואם המבט הסופי משאיר מספיק מקום לשלב העריכה הבא. שמרו את הווידאו המוגמר עם הפרומפט המדויק, תמונת המקור וההגדרות. בתיקון, שנו את כיוון המצלמה, התזמון או פעולת הנושא שגרמו לבעיה שנצפתה, והשוו את התוצאה לאותה תוכנית שוט.
Ailoot Ultra · וידאו POST /v1/videos minimaxi-i2v-01-director
minimaxi-i2v-01-directorהתחלה
I2V 01 Director מנפיש תמונת פריים ראשון באמצעות פקודות מפורשות לתנועת מצלמה בפרומפט. שלבו את הקומפוזיציה שסופקה עם פקודות truck, pan, push, tilt, zoom, tracking או הוראות למצלמה סטטית, כדי לתכנן שוט קצר.
- סוגי קלט נתמכים
- טקסט · תמונות
- תוצאות
- וידאו
זמין ב-Ailoot · קלט ושיטות
Ailoot Ultra · וידאו POST /v1/videos
- סוגי קלט
text,image- סוגי פלט
video
| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות minimaxi-i2v-01-director תנאים: יש להשתמש בבורר המודלים המדויק של Ailoot. | ברירת מחדל— |
שדהprompt | סוגstring | דרישהחובה | ערכים ומגבלות תנאים: תארו את הסצנה ואת התנועה. | ברירת מחדל— |
שדהend_image | סוגstring | דרישהרשות | ערכים ומגבלות תנאים: פריים סיום חל רק במצב נתמך של קלט תמונה. | ברירת מחדל— |
שדהimage | סוגstring or array<string> | דרישהרשות | ערכים ומגבלות תנאים: יש להשתמש בכתובת URL ממשית של תמונה הנגישה לציבור או במחרוזת תמונה ב־base64; אין כאן קביעה של מספר תמונות מרבי. | ברירת מחדל— |
פרמטרים ומחזור חיים של השיטה
| פרמטר | מפרט |
|---|---|
פרמטרcontent_type | מפרטapplication/json |
פרמטרrequired | מפרטmodel, prompt |
פרמטרoptional | מפרטend_image, image |
פרמטרmaterial_types | מפרטtext, image |
פרמטרconditions | מפרטיש להשתמש בבורר המודלים המדויק של Ailoot., תארו את הסצנה ואת התנועה., פריים סיום חל רק במצב נתמך של קלט תמונה., יש להשתמש בכתובת URL ממשית של תמונה הנגישה לציבור או במחרוזת תמונה ב־base64; אין כאן קביעה של מספר תמונות מרבי. |
כינויים לשיטה: /v1/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/media/assets
GET /v1/media/assets/{asset_id}
תעריפים
אופן חישוב החיוב הסופי
התעריפים המוצגים מספקים אומדן לעלות לפני היצירה. החיוב הסופי מחושב לפי העלות שנרשמה עבור היצירה המקורית. משך הפלט שנמדד והכמויות החזויות אינם הכמות הסופית לחיוב.
מידע תעריפים אינו מוסיף אפשרויות לבקשה. הפרמטרים הנתמכים מפורטים בשיטה שנבחרה.
- מצב מהיר
- לא צוין כאשר נבחר מצב מהיר
- מצב Flex
- לא צוין כאשר נבחר מצב flex
- מאמץ חשיבה מרבי
- לא צוין כאשר מאמץ החשיבה המרבי משתמש בהתאמת ברירת המחדל (default)
תעריפים משוערים להשוואה
מחירים לפי תצורה
התאימו כל חיוב לתנאים המוצגים. השתמשו בתעריף אחד לכל קבוצה של תצורות חלופיות.
| תצורה | טבלת תעריפים | כמות חזויה | כמות החיוב | חיוב |
|---|---|---|---|---|
| תצורהתעריפי בסיס לטוקנים | טבלת תעריפיםתעריף בסיס | כמות חזויה— | כמות החיוב— | חיוב קלט · טוקני קלט · אומדן להשוואה בלבד — / 1K טוקנים פלט · טוקני פלט · אומדן להשוואה בלבד — / 1K טוקנים קלט · קריאה מהמטמון · אומדן להשוואה בלבד — / 1K טוקנים קלט · כתיבה למטמון · אומדן להשוואה בלבד — / 1K טוקנים קלט · כתיבה למטמון, 1 שעה · אומדן להשוואה בלבד — / 1K טוקנים |
| תצורהלכל בקשה | טבלת תעריפים— | כמות חזויה— | כמות החיובבקשה אחת | חיוב קלט · אומדן להשוואה בלבד $1 לכל בקשה |
| תצורהעלות יצירה משוערת | טבלת תעריפים— | כמות חזויהאומדן ליצירה אחת | כמות החיוב— | חיוב פלט · עלות יצירה משוערת · אומדן להשוואה בלבד $1 אומדן לפני היצירה אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה. |
לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →
דוגמאות לבקשות
Ailoot Ultra · וידאו
# Replace YOUR_ACCESSIBLE_IMAGE_URL with your actual reachable reference image URL.
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
"model": "minimaxi-i2v-01-director",
"prompt": "A cat is walking on grass.",
"image": "YOUR_ACCESSIBLE_IMAGE_URL"
}
JSON
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
# Create once; retain id, polling_url, original task identifiers and every header.
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_STATUS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
u=urljoin("https://api.ailoot.ai",r["polling_url"])
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:
raise SystemExit("Unexpected returned polling URL; preserve the response")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True)
# Read this same original polling_url again while pending.
# Preserve unknown/result_pending_check; do not repeat creation.
PY_STATUS
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())
roles={}
def visit(v,path=""):
if isinstance(v,dict):
for k,x in v.items(): visit(x,path+"/"+k)
elif isinstance(v,list):
for i,x in enumerate(v): visit(x,path+"/"+str(i))
elif isinstance(v,str):
u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)
if p.scheme=="https" and p.netloc=="api.ailoot.ai" and not p.username and not p.password and p.path.startswith("/v1/media/assets/") and p.path.endswith("/content"):
roles.setdefault(u,[]).append(path)
visit(r)
if not roles: raise SystemExit("No completed owned assets; retain the original status")
manifest=[]
for i,(u,paths) in enumerate(roles.items()):
target=Path(f"asset-{i}.bin")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)
raw=target.read_bytes()
if not raw: raise SystemExit("Empty asset; retain original status and metadata")
ext="glb" if raw[:4]==b"glTF" else "png" if raw[:8]==b"\x89PNG\r\n\x1a\n" else "jpg" if raw[:3]==b"\xff\xd8\xff" else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "mp4" if raw[4:8]==b"ftyp" else "bin"
name=f"asset-{i}.{ext}"
if target.name!=name: target.rename(name)
manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})
Path("asset-manifest.json").write_text(json.dumps(manifest,indent=2))
print("Saved",len(manifest),"unique owned assets; every response role retained")
PY_ASSETS
קבלה ושמירה של תוצאות
Ailoot Ultra · וידאו
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
שמירת כל התוצאות שהושלמו
שמרו כל וידאו שהושלם או קובץ שהוחזר; אחזרו כל נכס מכל URL שהוחזר בפועל.
יש לשמור את התגובה המלאה ואת הכותרות, המזהים המקוריים, כל פלט ממשי ואת כל שדות השימוש והחיוב. יש לשמור כל נכס ייחודי שבבעלותכם ואת כל התפקידים המפנים אליו.
כשצריך לבדוק את התגובה המקורית
יש לשמור את מזהה המשימה הציבורי או מזהה הפעולה שהוחזרו ואת כל הכותרות. יש לקרוא רק את המשימה המקורית; unknown או result_pending_check אינם מתירים יצירה נוספת.
שדות התגובה
| שדה | סוג |
|---|---|
שדהid | סוגstring |
שדהpolling_url | סוגstring |
שדהprovider_task_id | סוגstring |
שדהtask_id | סוגstring |
שדהstatus | סוגstring |
שדהvideo_url | סוגstring |
כינויים
כינויים למודל
Ailoot Ultra minimaxi-i2v-01-director
כינויים לנתיבי שיטות
/v1/videos/generations
מזהי מודלים קשורים IDs
FAQ · MiniMax: I2V 01 Director
- אילו קלטים ותוצאות זמינים?
POST /v1/videos·minimaxi-i2v-01-director:text,image→video- באילו שדות הבקשה משתמשת?
POST /v1/videos·minimaxi-i2v-01-director:model,prompt,end_image,image