MiniMax-Hailuo-2.3

MiniMax Hailuo 2.3 יוצר סרטונים מטקסט או מתמונת פתיחה, עם בקרות לתנועה ולהכוונת המצלמה. בחרו שש שניות ב־768P או 1080P, או עשר שניות ב־768P, להופעות דמויות, לסצנות מסוגננות ולשוטים של מוצרים שאפשר לבדוק ולערוך.

Ailoot · וידאו POST /v1/videos/generations MiniMax-Hailuo-2.3
Ailoot Ultra · וידאו POST /v1/videos MiniMax-Hailuo-2.3

על המודל

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

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

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

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

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

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

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

תמונת הפתיחה יכולה להיות בפורמט JPG, JPEG, PNG או WebP, חייבת להיות קטנה מ־20 MB, צריכה צלע קצרה הגדולה מ־300 פיקסלים ויחס ממדים שבין 2:5 ל־5:2. אפשר לספק אותה ככתובת URL ציבורית של תמונה או ככתובת URL של נתונים ב־Base64. בחרו תמונת פתיחה ברורה במקום לסמוך על האנימציה שתתקן פנים מוסתרות או פעולה שכבר נחתכה.

Hailuo 2.3 יוצר בקצב 24 פריימים לשנייה. שוט של שש שניות יכול להשתמש ב־768P או 1080P; שוט של עשר שניות משתמש ב־768P. ברירות המחדל הן שש שניות ו־768P. בחרו את האורך לפי הפעולה שתרצו לראות: תגובה קצרה עשויה להתאים לשוט קצר, ותנועה איטית יותר דורשת יותר מקום. קראו את הרוחב והגובה בפועל של התוצאה שהושלמה כשמשלבים את הקליפ בעריכה, משום שתווית רזולוציה לבדה אינה החלטת מסגור מלאה.

אפשר להנחות את המצלמה באמצעות פקודות בסוגריים מרובעים. הבקרות הזמינות כוללות תנועה אופקית של המצלמה, סיבוב אופקי, התקרבות, תנועה אנכית, הטיה, זום, רעידה, מעקב ושוט סטטי. פקודה כגון [Push in] מכוונת את ההתקרבות; פקודות המקובצות באותו זוג סוגריים פועלות יחד, ואילו פקודות המוצבות לפי סדר מתארות רצף. MiniMax ממליצה על שלוש פקודות בו־זמניות לכל היותר. התאימו את תנועת המצלמה לפעולת הנושא כדי שיהיה קל לעקוב אחר האירוע המרכזי.

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

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

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

Ailoot · וידאו POST /v1/videos/generations MiniMax-Hailuo-2.3

MiniMax-Hailuo-2.3

MiniMax /MiniMax-Hailuo-2.3

התחלה

סוגי קלט נתמכים: טקסט · תמונות
תוצאות: וידאו

זמין ב-Ailoot · קלט ושיטות

Ailoot · וידאו POST /v1/videos/generations

סוגי קלט: text, image
סוגי פלט: video
פורמט פלט: mp4

שדה	סוג	דרישה	ערכים ומגבלות	ברירת מחדל
שדה`model`	סוג`string`	דרישהחובה	ערכים ומגבלות MiniMax-Hailuo-2.3	ברירת מחדל—
שדה`prompt`	סוג`string`	דרישהחובה	ערכים ומגבלות אורך מזערי: ⁦1⁩ אורך מרבי: ⁦2,000⁩ יחידה: תווי Unicode	ברירת מחדל—
שדה`duration`	סוג`integer`	דרישהרשות	ערכים ומגבלות ⁦6⁩, ⁦10⁩ תנאים: 10 שניות מחייבות 768P יחידה: שניות	ברירת מחדל⁦6⁩
שדה`resolution`	סוג`string`	דרישהרשות	ערכים ומגבלות 768P, 1080P תנאים: 1080P מחייב 6 שניות	ברירת מחדל768P
שדה`first_frame_image`	סוג`https_url\|data_image_url`	דרישהרשות	ערכים ומגבלות מספר בייטים מרבי לאחר פענוח: ⁦20,971,520⁩ סוגי MIME: image/jpeg, image/png, image/webp מידה מזערית ללא ערך הגבול: ⁦300⁩ טווח יחסי ממדים: 2:5, 5:2	ברירת מחדל—
שדה`prompt_optimizer`	סוג`boolean`	דרישהרשות	ערכים ומגבלות	ברירת מחדל—
שדה`fast_pretreatment`	סוג`boolean`	דרישהרשות	ערכים ומגבלות	ברירת מחדל—

שילובים של חומרי קלט

מתמונה לווידאו · נדרש: prompt, first_frame_image

מטקסט לווידאו · נדרש: prompt

פרמטרים ומחזור חיים של השיטה

פרמטר	מפרט
פרמטר`material_types`	מפרטtext, image
פרמטר`required`	מפרטnull
פרמטר`optional_controls`	מפרטnull

מחזור חיים: 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

מבני המתודות והמזהים מדויקים; יכולת הספק נפרדת מקבלת הבקשה לביצוע.

תעריפים

תעריפי שיטות Ailoot

Ailoot וידאוPOST /v1/videos/generations

פלט: ⁦‏0.28 ‏$⁩ לכל וידאו באורך 6 שניות ברזולוציית 768p

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

פרטי תעריף הייחוס

טבלאות הייחוס ברמת המודל אינן משנות את בחירת השיטה, הצעות המחיר או החיובים. החיובים בפועל משתמשים בתעריפי שיטת Ailoot שנבחרה.

MiniMax-Hailuo-2.3

מחירים לפי תצורה

תצורה	תנאי חיוב	חיוב
תצורהMiniMax-Hailuo-2.3 · תצורת ברירת המחדל	תנאי חיובתצורת ברירת מחדל	חיוב קלט · קלט ⁦‏0.00 ‏$⁩ לקריאה פלט · פלט ⁦‏0.60 ‏$⁩ לקריאה

MiniMax-Hailuo-2.3

מחירים לפי תצורה

תצורה	תנאי חיוב	חיוב
תצורהMiniMax-Hailuo-2.3 · תצורת ברירת המחדל	תנאי חיובתצורת ברירת מחדל	חיוב קלט · קלט ⁦‏0.00 ‏$⁩ לקריאה פלט · פלט ⁦‏1.20 ‏$⁩ לקריאה

MiniMax-Hailuo-2.3

מחירים לפי תצורה

תצורה	תנאי חיוב	חיוב
תצורהMiniMax-Hailuo-2.3 · תצורת ברירת מחדל	תנאי חיובתצורת ברירת מחדל	חיוב קלט · קלט ⁦‏0.00 ‏$⁩ לקריאה פלט · פלט ⁦‏1.20 ‏$⁩ לקריאה

דוגמאות לבקשות

Ailoot · וידאו

דוגמת וידאו

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl https://api.ailoot.ai/v1/videos/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "MiniMax-Hailuo-2.3", "prompt": "A person walks slowly through a quiet garden as the camera tracks from the side.", "duration": 6, "resolution": "768P"}'

קבלה ושמירה של תוצאות

Ailoot · וידאו

mp4

GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content

בדיקת מצב המשימה

GET · אחזור מצב

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id" \
  -H "Authorization: Bearer $AILOOT_API_KEY"

קריאות תוכן נוספות

GET · אחזור תוכן

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id/content" \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  --output video.mp4

שמירת כל התוצאות שהושלמו

שמרו כל וידאו שהושלם או קובץ שהוחזר; אחזרו כל נכס מכל URL שהוחזר בפועל.

יש לשמור כל פריט נתונים ואינדקס פלט שהוחזרו. content_url מתייחס רק לראשון; יש לאחזר כל נתיב תוכן או נכס ממשיים. GET לתוכן ללא index אינו מחזיר את כל הפלטים.

כשצריך לבדוק את התגובה המקורית

יש לקרוא את המשימה המקורית הקיימת; אין לשלוח שוב בקשה שתוצאת שליחתה אינה ידועה.

שדות התגובה

שדה	סוג
שדה`id`	סוגstring
שדה`object`	סוגstring
שדה`model`	סוגstring
שדה`status`	סוגstring
שדה`content_url`	סוגsigned URL
שדה`data[]`	סוגsigned URL
שדה`usage`	סוגobject
שדה`result_pending_check`	סוגboolean

שגיאות והשלבים הבאים

תגובה	תנאי	השלב הבא
תגובה⁦400⁩ · `invalid_request_error`	תנאישדות נדרשים, ייצוג חומר או ערך פרמטר שאינם תקינים	השלב הבאתקנו את השדות שצוינו לפני בקשת יצירה חדשה.
תגובה⁦409⁩ · `video_not_ready`	תנאיתוכן התוצאה המקורית עדיין אינו זמין	השלב הבאיש לבדוק במחזוריות את המזהה המקורי שהוחזר ולכבד את Retry-After.
תגובה`server_error`	תנאיהתשובה שהוחזרה מציינת שהפעולה או התוצאה דורשת בדיקה	השלב הבאשמרו את מזהה הפעולה/המשימה המקורי שהוחזר, את כותרות הבקשה ואת התשובה; המשיכו לבצע פעולות קריאה נתמכות של אותה פעולה מקורית. אל תשלחו שוב את בקשת היצירה.

כינויים

כינויים למודל

Ailoot MiniMax-Hailuo-2.3
Ailoot Ultra MiniMax-Hailuo-2.3

כינויים לנתיבי שיטות

/v1/videos/generations, /videos, /videos/generations

מזהי מודלים קשורים IDs

MiniMax-Hailuo-2.3, MiniMax-Hailuo-2.3

Ailoot Ultra · וידאו POST /v1/videos MiniMax-Hailuo-2.3

MiniMax-Hailuo-2.3

MiniMax /MiniMax-Hailuo-2.3

התחלה

סוגי קלט נתמכים: טקסט
תוצאות: וידאו

זמין ב-Ailoot · קלט ושיטות

Ailoot Ultra · וידאו POST /v1/videos

סוגי קלט: text
סוגי פלט: video
פורמט פלט: mp4
מספר פלטים: עד ⁦1⁩ פלט

שדה	סוג	דרישה	ערכים ומגבלות	ברירת מחדל
שדה`model`	סוג`string`	דרישהחובה	ערכים ומגבלות MiniMax-Hailuo-2.3	ברירת מחדל—
שדה`prompt`	סוג`string`	דרישהחובה	ערכים ומגבלות אורך מזערי: ⁦1⁩ אורך מרבי: ⁦2,000⁩ תנאים: עבור 768P: לכל היותר 2000 נקודות קוד של Unicode. עבור 1080P: פחות מ־200 נקודות קוד של Unicode (לכל היותר 199). ההנחיה חייבת להכיל טקסט שאינו רק תווי רווח. יחידה: תווי Unicode	ברירת מחדל—
שדה`duration`	סוג`integer`	דרישהחובה	ערכים ומגבלות ⁦6⁩ יחידה: שניות	ברירת מחדל—
שדה`resolution`	סוג`string`	דרישהחובה	ערכים ומגבלות 768P, 1080P	ברירת מחדל—

שילובים של חומרי קלט

מטקסט לווידאו · נדרש: prompt

פרמטרים ומחזור חיים של השיטה

פרמטר	מפרט
פרמטר`content_type`	מפרטapplication/json
פרמטר`required`	מפרטmodel, prompt, duration, resolution
פרמטר`other_options`	מפרטfalse
פרמטר`duration`	מפרט6
פרמטר`resolution`	מפרט768P, 1080P
פרמטר`prompt_max_characters`	מפרט2000
פרמטר`material_types`	מפרטtext
פרמטר`prompt_max_characters_by_resolution`	מפרט{"768P":2000,"1080P":199}

כינויים לשיטה: /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)

תעריפי Ailoot

מחירים לפי תצורה

התאימו כל חיוב לתנאים המוצגים. השתמשו בתעריף אחד לכל קבוצה של תצורות חלופיות.

תצורה	טבלת תעריפים	משך נומינלי של קטע, בשניות	רזולוציה	יחידת חיוב	חיוב
תצורהתעריפי בסיס לטוקנים	טבלת תעריפיםתעריף בסיס	משך נומינלי של קטע, בשניות—	רזולוציה—	יחידת חיוב—	חיוב קלט · טוקני קלט — / 1K טוקנים פלט · טוקני פלט — / 1K טוקנים קלט · קריאה מהמטמון — / 1K טוקנים קלט · כתיבה למטמון — / 1K טוקנים קלט · כתיבה למטמון, 1 שעה — / 1K טוקנים
תצורהUltra	טבלת תעריפים—	משך נומינלי של קטע, בשניות⁦6⁩	רזולוציה1080P	יחידת חיובלכל קטע פלט באורך נומינלי של 6s	חיוב פלט · מקטע פלט באורך נומינלי של 6s $1.2 לכל קטע פלט באורך נומינלי של 6s
תצורהUltra	טבלת תעריפים—	משך נומינלי של קטע, בשניות⁦6⁩	רזולוציה768P	יחידת חיובלכל קטע פלט באורך נומינלי של 6s	חיוב פלט · מקטע פלט באורך נומינלי של 6s $0.6 לכל קטע פלט באורך נומינלי של 6s

פרטי תעריף הייחוס

MiniMax-Hailuo-2.3

מחירים לפי תצורה

תצורה	תנאי חיוב	חיוב
תצורהMiniMax-Hailuo-2.3 · תצורת ברירת המחדל	תנאי חיובתצורת ברירת מחדל	חיוב קלט · קלט ⁦‏0.00 ‏$⁩ לקריאה פלט · פלט ⁦‏0.60 ‏$⁩ לקריאה

MiniMax-Hailuo-2.3

מחירים לפי תצורה

תצורה	תנאי חיוב	חיוב
תצורהMiniMax-Hailuo-2.3 · תצורת ברירת המחדל	תנאי חיובתצורת ברירת מחדל	חיוב קלט · קלט ⁦‏0.00 ‏$⁩ לקריאה פלט · פלט ⁦‏1.20 ‏$⁩ לקריאה

MiniMax-Hailuo-2.3

מחירים לפי תצורה

תצורה	תנאי חיוב	חיוב
תצורהMiniMax-Hailuo-2.3 · תצורת ברירת מחדל	תנאי חיובתצורת ברירת מחדל	חיוב קלט · קלט ⁦‏0.00 ‏$⁩ לקריאה פלט · פלט ⁦‏1.20 ‏$⁩ לקריאה

דוגמאות לבקשות

Ailoot Ultra · וידאו

curlcurl · 1080P / 6 שניות

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "MiniMax-Hailuo-2.3", "prompt": "A cat in a spacesuit walking on the Moon", "duration": 6, "resolution": "768P"}')

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

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "MiniMax-Hailuo-2.3", "prompt": "A cat in a spacesuit walking on the Moon", "duration": 6, "resolution": "1080P"}')

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

קבלה ושמירה של תוצאות

Ailoot Ultra · וידאו

mp4

GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content

בדיקת מצב המשימה

GET · אחזור מצב

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_OPERATION_ID
operation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/$operation_id" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o status.json
python3 - <<'PY_STATUS'
import json
from pathlib import Path
r=json.loads(Path("status.json").read_text())
print(json.dumps(r))
if r.get("status")=="completed":
    for x in r.get("data",[]):print(x)
PY_STATUS

שמירת כל הנכסים שהושלמו

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

קריאות תוכן נוספות

GET · אחזור תוכן

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_OPERATION_ID
operation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/$operation_id/content" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4

שמירת כל התוצאות שהושלמו

שמרו כל וידאו שהושלם או קובץ שהוחזר; אחזרו כל נכס מכל URL שהוחזר בפועל.

data[] שהושלם מכיל את כל כתובות ה־URL החתומות לתוכן שבבעלותכם. יש לאחזר כל כתובת URL שהוחזרה, או להשתמש בנקודת הקצה לתוכן עם index המוגדר לאינדקס של פלט ממשי. משימה מקורית שנכשלה עשויה להחזיר charge_pending_check; יש לבדוק את המשימה המקורית הזו במקום ליצור אותה שוב.

כשצריך לבדוק את התגובה המקורית

יש לקרוא את המשימה המקורית הקיימת; אין לשלוח שוב בקשה שתוצאת שליחתה אינה ידועה.

מספר פלטים מרבי: ⁦1⁩.

שדות התגובה

שדה	סוג
שדה`id`	סוגstring
שדה`object`	סוגstring
שדה`model`	סוגstring
שדה`status`	סוגstring
שדה`data[]`	סוגsigned content URL
שדה`charge_pending_check`	סוגboolean
שדה`error.code`	סוגstring
שדה`error.message`	סוגstring
שדה`requested_nominal_duration_seconds`	סוגinteger
שדה`measured_duration_seconds`	סוגnumber
שדה`width`	סוגinteger
שדה`height`	סוגinteger

שגיאות והשלבים הבאים

תגובה	תנאי	השלב הבא
תגובה⁦400⁩ · `invalid_request_error`	תנאישדות נדרשים, ייצוג חומר או ערך פרמטר שאינם תקינים	השלב הבאתקנו את השדות שצוינו לפני בקשת יצירה חדשה.
תגובה⁦409⁩ · `video_not_ready`	תנאיתוכן התוצאה המקורית עדיין אינו זמין	השלב הבאיש לבדוק במחזוריות את המזהה המקורי שהוחזר ולכבד את Retry-After.
תגובה`server_error`	תנאיהתשובה שהוחזרה מציינת שהפעולה או התוצאה דורשת בדיקה	השלב הבאשמרו את מזהה הפעולה/המשימה המקורי שהוחזר, את כותרות הבקשה ואת התשובה; המשיכו לבצע פעולות קריאה נתמכות של אותה פעולה מקורית. אל תשלחו שוב את בקשת היצירה.

כינויים

כינויים למודל

Ailoot MiniMax-Hailuo-2.3
Ailoot Ultra MiniMax-Hailuo-2.3

כינויים לנתיבי שיטות

/v1/videos/generations, /videos, /videos/generations

מזהי מודלים קשורים IDs

MiniMax-Hailuo-2.3, MiniMax-Hailuo-2.3

FAQ · MiniMax-Hailuo-2.3

אילו קלטים ותוצאות זמינים?

POST /v1/videos/generations · MiniMax-Hailuo-2.3: text, image → video

POST /v1/videos · MiniMax-Hailuo-2.3: text → video

באילו שדות הבקשה משתמשת?

POST /v1/videos/generations · MiniMax-Hailuo-2.3: model, prompt, duration, resolution, first_frame_image, prompt_optimizer, fast_pretreatment

POST /v1/videos · MiniMax-Hailuo-2.3: model, prompt, duration, resolution

אילו מגבלות חלות?

POST /v1/videos/generations · MiniMax-Hailuo-2.3: prompt.maximum_length: 2000

POST /v1/videos · MiniMax-Hailuo-2.3: prompt.maximum_length: 2000

MiniMax-Hailuo-2.3