{ "aboutHtml": "

תוצאה אחת של תמונה וקול מבריף רב־מודאלי

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

המערכת המתועדת מפיקה וידאו באורך 4–15 שניות בקצב 24 פריימים לשנייה עם אודיו סטריאופוני ב־32 kHz. יצירת H3-Base פועלת ב־768p; תהליך העבודה המלא של 2K יוצר מחדש את התוצאה באמצעות ההקשר הרב־מודאלי המקורי. זהו יותר משינוי גודל רגיל: השלב השני משתמש שוב במודל ובהקשר המקור כדי לשחזר פרטים עדינים. ל־H3 Max ול־H3-Context-IR יש תפקידים ומגבלות נפרדים.

יצירה מטקסט ובהנחיית פריימים

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

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

יצירה ועריכה בהנחיית ייחוסים

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

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

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

דיבור, קול ותזמון השוט

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

מדריכי כתיבת ההנחיות של היצרן משתמשים באנגלית בחלקים התיאוריים, תוך שמירה על הדיאלוג והטקסט הגלוי בשפתם המקורית. תוכן מדובר משתמש ב־<d>[Language] ...</d>, כאשר זהות הדובר ותיאור הקול מופיעים מחוץ לבלוק. הבחינו בין דיבור פיזי לבין קריינות מחוץ לפריים, וציינו מתי שורה נמשכת מעבר לחיתוך או נקטעת בסיום. שמרו גם על הטקסט הגלוי בדיוק. התאימו את כמות הדיבור למשך שנבחר ובדקו יחד את המילים המוצגות ואת השורה הנשמעת.

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

הכנת הקלט ומגבלות מספריות

סכמת היצירה הנוכחית מחייבת טקסט שאינו ריק בכל מצב, באורך של עד 7,000 תווים לכל פריט טקסט. תמונות יכולות להיות בפורמט JPG, JPEG, PNG, WebP, HEIC או HEIF, עד 30 MB כל אחת, עם כל צלע בין 256 ל־5,760 פיקסלים ויחס ממדים בין 0.4 ל־2.5. קלט פריימים מאפשר תמונת פתיחה אחת ותמונת סיום אחת; מצב הייחוסים מאפשר עד תשע תמונות ייחוס.

וידאו לייחוס יכול לכלול עד שלושה קליפים בפורמט MP4 או MOV, כל אחד באורך 2–15 שניות ובאורך כולל שאינו עולה על 15 שניות. קליפ יכול להיות בגודל של עד 50 MB; קידוד הווידאו שלו הוא H.264 או H.265, עם אודיו AAC או MP3, צלעות שבין 256 ל־5,760 פיקסלים, יחסי ממדים שבין 0.4 ל־2.5 וקצב פריימים שבין 23.976 ל־60. אודיו לייחוס תומך בעד שלושה קליפים בפורמט WAV או MP3, עד 15 MB כל אחד, כל אחד באורך 2–15 שניות ובאורך כולל שאינו עולה על 15 שניות. כרטיס המודל מגביל קלטי ייחוס מעורבים ל־12 קבצים. מגבלת גוף הבקשה המתועדת היא 64 MB, בנפרד מהמגבלות לכל קובץ.

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

מבנה הפלט והמערכת המלאה

ממשק H3 של היצרן מציע 768P ו־2K. יצירה מטקסט בלבד מחייבת יחס ממדים מוגדר: 21:9, 16:9, 4:3, 1:1, 3:4 או 9:16. יצירה מפריים ראשון ואחרון מקבלת את יחס הממדים שלה מתמונת הקלט; יצירה מייחוסים יכולה להשתמש ביחס מותאם אוטומטית או מפורש. משך הפלט במספר שלם הוא 4–15 שניות.

כרטיס המודל מבחין בין H3-Context-IR, שמפרש ומעשיר את הבריף, H3-Base, שיוצר תוכן של תמונה וקול, ו־H3-Regenerate-2K, שיוצר את התוצאה ברזולוציה הגבוהה יותר. נקודות הביקורת הבסיסיות ששוחררו מפרידות בין משימות בהנחיית פריימים לבין משימות עם מכלול ייחוסים. רכיבי ההקשר והיצירה מחדש נפרדים מאותם משקלי בסיס, ולכן שם של נקודת ביקורת פתוחה לבדו אינו מעיד על התנהגות המערכת כולה.

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

", "aboutText": "תוצאה אחת של תמונה וקול מבריף רב־מודאלי\n\nMiniMax H3 הוא מערכת הווידאו הרב־מודאלית הכוללת של MiniMax. הוא מפרש יחד טקסט, תמונות, וידאו ואודיו, ואז יוצר וידאו עם קול סטריאופוני מובנה. היצרן מציג אותו לעבודה יצירתית קצרה, כגון המחשות מוצר, פרסום, כרזות מונפשות וקונספטים לכותרות סרטים, שבה היחסים בין נכסי הייחוס חשובים לא פחות מתיאור הסצנה.\n\nהמערכת המתועדת מפיקה וידאו באורך 4–15 שניות בקצב 24 פריימים לשנייה עם אודיו סטריאופוני ב־32 kHz. יצירת H3-Base פועלת ב־768p; תהליך העבודה המלא של 2K יוצר מחדש את התוצאה באמצעות ההקשר הרב־מודאלי המקורי. זהו יותר משינוי גודל רגיל: השלב השני משתמש שוב במודל ובהקשר המקור כדי לשחזר פרטים עדינים. ל־H3 Max ול־H3-Context-IR יש תפקידים ומגבלות נפרדים.\n\nיצירה מטקסט ובהנחיית פריימים\n\nקלט של טקסט בלבד מתאר את ציר הזמן המלא של התמונה והקול. תמונה ראשונה מעגנת את הפתיחה, תמונה אחרונה מעגנת את הסיום, ושתי תמונות יכולות להגדיר את שניהם. לשוט מפריים ראשון, התחילו בקומפוזיציה ובזהות הגלויות בתמונת הסטילס, ואז תארו את הפעולה המתפתחת ממנה. למעבר מפריים ראשון לפריים אחרון, תארו את התנועה הנראית המחברת בין שני המצבים במקום לחזור על שני תיאורי תמונות שאינם קשורים.\n\nבריף מוצר מעשי יכול להגדיר אריזה סגורה בפריים הפתיחה, את היד שפותחת אותה, תנועת מצלמה עדינה ואת המצב הסופי שאליו יש להגיע. שמרו בפריימים שסופקו על צורת העצם, מיקום התווית והתאורה. יצירה בהנחיית פריימים ויצירה בהנחיית ייחוסים הן מצבי קלט נפרדים; ממשק היצרן אינו משלב תפקידי פריים ראשון ואחרון עם תפקידי מדיית ייחוס בבקשה אחת.\n\nיצירה ועריכה בהנחיית ייחוסים\n\nמצב הייחוסים מקבל טקסט עם תמונות, קליפי וידאו וקליפי אודיו. הגדירו מה כל מקור תורם: מראה של דמות, מיקום, תנועת מצלמה, המבנה הזמני של קליפ מקור או קול. סרטון המשמש רק לתנועת מצלמה שונה מסרטון שאותו צריך לערוך או להמשיך בפועל. ציינו את היחס הזה במפורש.\n\nמדריך הייחוסים של היצרן מפריד בין הגדרות נושאים, סיכום משימה, ניתוח שימור, תיאור שוט מפורט, סביבת קול כוללת ומוזיקת רקע המיועדת לקהל בלבד. הוא מבחין בין שימור תוכן גלוי לבין העברת מאפיינים או ייחוס סגנוני רחב. באודיו, העתקת אות שונה מהתייחסות לגון, לקצב או לאופן הביצוע. שמרו על התפקידים האלה לאורך הבריף.\n\nלסצנה המבוססת על ייחוסים, ספקו תמונת דמות, ייחוס קצר לתנועת מצלמה וייחוס קולי, ואז תארו היכן כל אחד מהם צריך להשפיע על שוט היעד. ציינו אילו פרטי לבוש, סביבה או עצמים חייבים להישאר מזוהים. השוו את הקליפ המוגמר לדרישות האלה, לרבות רציפות התנועה והקשר בין הדובר הנראה לקול שנשמע.\n\nדיבור, קול ותזמון השוט\n\nH3 ממדל יחד דיאלוג, קולות פיזיים, אווירה ומוזיקה. כרטיס המודל מתעד תמיכה יציבה בדיאלוג בערבית, בסינית, באנגלית, בצרפתית, בגרמנית, באיטלקית, ביפנית, בקוריאנית, בפורטוגזית, ברוסית ובספרדית; התמיכה בשפות אחרות מתוארת כמשתנה. ספקו את המילים המדוברות המדויקות ואת השפה, עם זהות דובר יציבה בין שוטים.\n\nמדריכי כתיבת ההנחיות של היצרן משתמשים באנגלית בחלקים התיאוריים, תוך שמירה על הדיאלוג והטקסט הגלוי בשפתם המקורית. תוכן מדובר משתמש ב־`[Language] ...`, כאשר זהות הדובר ותיאור הקול מופיעים מחוץ לבלוק. הבחינו בין דיבור פיזי לבין קריינות מחוץ לפריים, וציינו מתי שורה נמשכת מעבר לחיתוך או נקטעת בסיום. שמרו גם על הטקסט הגלוי בדיוק. התאימו את כמות הדיבור למשך שנבחר ובדקו יחד את המילים המוצגות ואת השורה הנשמעת.\n\nתארו תנועת מצלמה כפעולה, לרבות הטווח והמהירות כאשר הם חשובים. מספרו שוטים לפי סדר הניגון ושמרו את זמני החיתוך בתוך משך הסרטון. הפרידו בין קולות הסצנה, כגון צעדים או סגירת דלת, לבין מוזיקת רקע שרק הקהל שומע. בחירות אלה מקלות לפרש תוכנית שוטים קצרה ולבדוק אותה מול תוצאתה.\n\nהכנת הקלט ומגבלות מספריות\n\nסכמת היצירה הנוכחית מחייבת טקסט שאינו ריק בכל מצב, באורך של עד 7,000 תווים לכל פריט טקסט. תמונות יכולות להיות בפורמט JPG, JPEG, PNG, WebP, HEIC או HEIF, עד 30 MB כל אחת, עם כל צלע בין 256 ל־5,760 פיקסלים ויחס ממדים בין 0.4 ל־2.5. קלט פריימים מאפשר תמונת פתיחה אחת ותמונת סיום אחת; מצב הייחוסים מאפשר עד תשע תמונות ייחוס.\n\nוידאו לייחוס יכול לכלול עד שלושה קליפים בפורמט MP4 או MOV, כל אחד באורך 2–15 שניות ובאורך כולל שאינו עולה על 15 שניות. קליפ יכול להיות בגודל של עד 50 MB; קידוד הווידאו שלו הוא H.264 או H.265, עם אודיו AAC או MP3, צלעות שבין 256 ל־5,760 פיקסלים, יחסי ממדים שבין 0.4 ל־2.5 וקצב פריימים שבין 23.976 ל־60. אודיו לייחוס תומך בעד שלושה קליפים בפורמט WAV או MP3, עד 15 MB כל אחד, כל אחד באורך 2–15 שניות ובאורך כולל שאינו עולה על 15 שניות. כרטיס המודל מגביל קלטי ייחוס מעורבים ל־12 קבצים. מגבלת גוף הבקשה המתועדת היא 64 MB, בנפרד מהמגבלות לכל קובץ.\n\nבחרו רק ייחוסים שתורמים לבריף והבהירו את התרומה של כל אחד. תצוגה ברורה של הנושא שימושית יותר מכמה תצוגות סותרות ללא הסבר. שמרו על סדר הייחוסים, חתכו חומר לא רלוונטי בלי להסיר הקשר הכרחי לסצנה, ובדקו שקליפי מקור קצרים כוללים את הפעולה או מאפיין הקול שהתבקשו.\n\nמבנה הפלט והמערכת המלאה\n\nממשק H3 של היצרן מציע 768P ו־2K. יצירה מטקסט בלבד מחייבת יחס ממדים מוגדר: 21:9, 16:9, 4:3, 1:1, 3:4 או 9:16. יצירה מפריים ראשון ואחרון מקבלת את יחס הממדים שלה מתמונת הקלט; יצירה מייחוסים יכולה להשתמש ביחס מותאם אוטומטית או מפורש. משך הפלט במספר שלם הוא 4–15 שניות.\n\nכרטיס המודל מבחין בין H3-Context-IR, שמפרש ומעשיר את הבריף, H3-Base, שיוצר תוכן של תמונה וקול, ו־H3-Regenerate-2K, שיוצר את התוצאה ברזולוציה הגבוהה יותר. נקודות הביקורת הבסיסיות ששוחררו מפרידות בין משימות בהנחיית פריימים לבין משימות עם מכלול ייחוסים. רכיבי ההקשר והיצירה מחדש נפרדים מאותם משקלי בסיס, ולכן שם של נקודת ביקורת פתוחה לבדו אינו מעיד על התנהגות המערכת כולה.\n\nתהליך היצירה של היצרן הוא אסינכרוני. ממשק שאילתות המשימות שלו מאחזר משימות משבעת הימים האחרונים. שמרו את מזהה המשימה עד שמתקבלת תוצאת הווידאו בפועל, ואז שמרו את הקליפ במקום לשמור רק כתובת הורדה מוגבלת בזמן. בדקו זהות חזותית, טקסט קטן, אינטראקציות בין עצמים, תוכן מדובר ותזמון קול בגודל הצפייה המיועד. היצרן מציין שהבנה רב־מודאלית ופרטים חזותיים עדינים עדיין נמצאים בשיפור מתמשך; בריף מפורט והשוואה למקורות נשארים מרכזיים להשגת תוצאה שימושית.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "5b48a16d503fe97e0ce4af05a28c877c1e999e498faab4ae8eb0d0dba2683d33", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "he", "methods": [ { "html": "
MM

MiniMax: H3

MiniMax /minimax/hailuo-3

התחלה

MiniMax H3 יוצר וידאו קצר עם אודיו סטריאופוני מובנה מטקסט, מתמונות פריים או מייחוסים רב־מודאליים. הוא תומך ביצירה באמצעות פריים ראשון ואחרון, בעריכה המונחית באמצעות ייחוסים ובקשרים של תנועה או קול, עם פלט באורך 4–15 שניות ותהליך נפרד ליצירה מחדש ב־2K.

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

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

תוצאה אחת של תמונה וקול מבריף רב־מודאלי

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

המערכת המתועדת מפיקה וידאו באורך 4–15 שניות בקצב 24 פריימים לשנייה עם אודיו סטריאופוני ב־32 kHz. יצירת H3-Base פועלת ב־768p; תהליך העבודה המלא של 2K יוצר מחדש את התוצאה באמצעות ההקשר הרב־מודאלי המקורי. זהו יותר משינוי גודל רגיל: השלב השני משתמש שוב במודל ובהקשר המקור כדי לשחזר פרטים עדינים. ל־H3 Max ול־H3-Context-IR יש תפקידים ומגבלות נפרדים.

יצירה מטקסט ובהנחיית פריימים

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

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

יצירה ועריכה בהנחיית ייחוסים

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

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

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

דיבור, קול ותזמון השוט

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

מדריכי כתיבת ההנחיות של היצרן משתמשים באנגלית בחלקים התיאוריים, תוך שמירה על הדיאלוג והטקסט הגלוי בשפתם המקורית. תוכן מדובר משתמש ב־<d>[Language] ...</d>, כאשר זהות הדובר ותיאור הקול מופיעים מחוץ לבלוק. הבחינו בין דיבור פיזי לבין קריינות מחוץ לפריים, וציינו מתי שורה נמשכת מעבר לחיתוך או נקטעת בסיום. שמרו גם על הטקסט הגלוי בדיוק. התאימו את כמות הדיבור למשך שנבחר ובדקו יחד את המילים המוצגות ואת השורה הנשמעת.

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

הכנת הקלט ומגבלות מספריות

סכמת היצירה הנוכחית מחייבת טקסט שאינו ריק בכל מצב, באורך של עד 7,000 תווים לכל פריט טקסט. תמונות יכולות להיות בפורמט JPG, JPEG, PNG, WebP, HEIC או HEIF, עד 30 MB כל אחת, עם כל צלע בין 256 ל־5,760 פיקסלים ויחס ממדים בין 0.4 ל־2.5. קלט פריימים מאפשר תמונת פתיחה אחת ותמונת סיום אחת; מצב הייחוסים מאפשר עד תשע תמונות ייחוס.

וידאו לייחוס יכול לכלול עד שלושה קליפים בפורמט MP4 או MOV, כל אחד באורך 2–15 שניות ובאורך כולל שאינו עולה על 15 שניות. קליפ יכול להיות בגודל של עד 50 MB; קידוד הווידאו שלו הוא H.264 או H.265, עם אודיו AAC או MP3, צלעות שבין 256 ל־5,760 פיקסלים, יחסי ממדים שבין 0.4 ל־2.5 וקצב פריימים שבין 23.976 ל־60. אודיו לייחוס תומך בעד שלושה קליפים בפורמט WAV או MP3, עד 15 MB כל אחד, כל אחד באורך 2–15 שניות ובאורך כולל שאינו עולה על 15 שניות. כרטיס המודל מגביל קלטי ייחוס מעורבים ל־12 קבצים. מגבלת גוף הבקשה המתועדת היא 64 MB, בנפרד מהמגבלות לכל קובץ.

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

מבנה הפלט והמערכת המלאה

ממשק H3 של היצרן מציע 768P ו־2K. יצירה מטקסט בלבד מחייבת יחס ממדים מוגדר: 21:9, 16:9, 4:3, 1:1, 3:4 או 9:16. יצירה מפריים ראשון ואחרון מקבלת את יחס הממדים שלה מתמונת הקלט; יצירה מייחוסים יכולה להשתמש ביחס מותאם אוטומטית או מפורש. משך הפלט במספר שלם הוא 4–15 שניות.

כרטיס המודל מבחין בין H3-Context-IR, שמפרש ומעשיר את הבריף, H3-Base, שיוצר תוכן של תמונה וקול, ו־H3-Regenerate-2K, שיוצר את התוצאה ברזולוציה הגבוהה יותר. נקודות הביקורת הבסיסיות ששוחררו מפרידות בין משימות בהנחיית פריימים לבין משימות עם מכלול ייחוסים. רכיבי ההקשר והיצירה מחדש נפרדים מאותם משקלי בסיס, ולכן שם של נקודת ביקורת פתוחה לבדו אינו מעיד על התנהגות המערכת כולה.

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

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

Ailoot Ultra · וידאו POST /v1/videos
סוגי קלט
text, image, audio, video
סוגי פלט
video
פורמט פלט
הבתים המקוריים של MP4; ללא נרמול או המרת קידוד
שדהסוגדרישהערכים ומגבלותברירת מחדל
שדהmodelסוגstringדרישהחובהערכים ומגבלות
minimax/hailuo-3
ברירת מחדל—
שדהpromptסוגstringדרישהחובהערכים ומגבלותברירת מחדל—
שדהdurationסוגintegerדרישהחובהערכים ומגבלות
⁦5⁩, ⁦6⁩, ⁦7⁩, ⁦8⁩, ⁦9⁩, ⁦10⁩, ⁦11⁩, ⁦12⁩, ⁦13⁩, ⁦14⁩, ⁦15⁩
מינימום: ⁦1⁩
מקסימום: ⁦600⁩
ברירת מחדל—
שדהresolutionסוגstringדרישהרשותערכים ומגבלות
2K
ברירת מחדל—
שדהaspect_ratioסוגstringדרישהרשותערכים ומגבלות
21:9, 16:9, 4:3, 1:1, 3:4, 9:16
ברירת מחדל—
שדהgenerate_audioסוגbooleanדרישהרשותערכים ומגבלות
false, true
ברירת מחדל—
שדהframe_imagesסוגarrayדרישהרשותערכים ומגבלות
מספר פריטים מזערי: ⁦1⁩
מספר פריטים מרבי: ⁦2⁩
תוכן הקלט: מערך אובייקטים של פריימים. כל אובייקט כולל type=image_url, שדה image_url המכיל url, ו־frame_type. יש להשתמש בכתובת URL של תמונה ב־HTTPS ולהגדיר frame_type לערך first_frame או last_frame. כל תפקיד של פריים מופיע פעם אחת לכל היותר.
מפתחות מדויקים: type, image_url, frame_type
תנאים: המפתחות האלה מתארים כל אובייקט פריים; image_url מכיל רק url. יש להשמיט frame_images בבקשה המבוססת על טקסט בלבד.
ברירת מחדל—
שדהinput_referencesסוגarrayדרישהרשותערכים ומגבלותברירת מחדל—
שדהcallback_urlסוגstringדרישהרשותערכים ומגבלות
תבנית: ^https://
ברירת מחדל—
שדהsession_idסוגstringדרישהרשותערכים ומגבלותברירת מחדל—
שדהtraceסוגobjectדרישהרשותערכים ומגבלותברירת מחדל—
שדהuserסוגstringדרישהרשותערכים ומגבלותברירת מחדל—
שילובים של חומרי קלט

מטקסט לווידאו · הנחיה כתובה. · נדרש: model, prompt, duration

יש לספק prompt כטקסט ו־duration בשניות שלמות. יש לבחור רזולוציה נתמכת ובמידת הצורך גם יחס גובה־רוחב.

model: סוג: string · minimax/hailuo-3

prompt: סוג: string · מספר בייטים מרבי ב-UTF-8: ⁦10,000⁩ · נדרשים תווים שאינם רווחים: כן

מתמונה לווידאו · הנחיה כתובה ותמונה של הפריים הראשון. · נדרש: model, prompt, duration, frame_images

frame_images הוא מערך. כל אובייקט פריים כולל type, image_url ו־frame_type; השדה image_url מכיל url. יש להגדיר type לערך image_url. יש להשתמש ב־first_frame, עם last_frame אופציונלי. כל תפקיד של פריים מופיע פעם אחת לכל היותר. יש לספק כתובת URL ציבורית של תמונה ב־HTTPS לכל פריים. יש להשתמש בתמונות פריימים או בתמונות עזר בבקשה אחת; אין לשלב את שתיהן. יש לבחור רזולוציה נתמכת ובמידת הצורך גם יחס גובה־רוחב.

המפתחות המדויקים: type, image_url, frame_type

model: סוג: string · minimax/hailuo-3

prompt: סוג: string · מספר בייטים מרבי ב-UTF-8: ⁦10,000⁩ · נדרשים תווים שאינם רווחים: כן

Reference to video · הנחיה כתובה וחומרי עזר נתמכים מסוג תמונה, וידאו ואודיו. · נדרש: model, prompt, duration, input_references

input_references הוא מערך אובייקטים. יש להגדיר type לערך image_url, video_url, audio_url ולהשתמש בשדה המתאים המכיל url. יש להשתמש בכתובות HTTPS ציבוריות. יש להשמיט frame_images כדי לבחור מצב חומרי עזר. האומדן כולל את הרכיב המוצג לכל תמונה רק עבור תמונות עזר מעבר לחמש הראשונות. החיוב הסופי נקבע לפי התצורה שחויבה בפועל. אין לשלב תמונות עזר עם תמונות פריימים. יש לבחור רזולוציה נתמכת ובמידת הצורך גם יחס גובה־רוחב.

model: סוג: string · minimax/hailuo-3

prompt: סוג: string · מספר בייטים מרבי ב-UTF-8: ⁦10,000⁩ · נדרשים תווים שאינם רווחים: כן

פרמטרים ומחזור חיים של השיטה
פרמטרמפרט
פרמטרcontent_typeמפרטapplication/json
פרמטרrequiredמפרטmodel, prompt, duration
פרמטרmaterial_typesמפרטtext, image, audio, video
פרמטרadditional_propertiesמפרטfalse
פרמטרoptional_controlsמפרטresolution, aspect_ratio, generate_audio, frame_images, input_references, callback_url, session_id, trace, user

מחזור חיים: submit_once_poll_original

GET /v1/videos/{public_id}

GET /v1/videos/{public_id}/content

תעריפים

אופן חישוב החיוב הסופי

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

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

מצב מהיר
לא צוין כאשר נבחר מצב מהיר
מצב Flex
לא צוין כאשר נבחר מצב flex
מאמץ חשיבה מרבי
לא צוין כאשר מאמץ החשיבה המרבי משתמש בהתאמת ברירת המחדל (default)

תעריפים משוערים להשוואה

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

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

תצורהטבלת תעריפיםכמות חזויהיחידת חיובתנאי חיובחיוב
תצורהתעריפי בסיס לטוקניםטבלת תעריפיםתעריף בסיסכמות חזויה—יחידת חיוב—תנאי חיוב—חיוב
קלט · טוקני קלט · אומדן להשוואה בלבד — / 1K טוקנים
פלט · טוקני פלט · אומדן להשוואה בלבד — / 1K טוקנים
קלט · קריאה מהמטמון · אומדן להשוואה בלבד — / 1K טוקנים
קלט · כתיבה למטמון · אומדן להשוואה בלבד — / 1K טוקנים
קלט · כתיבה למטמון, 1 שעה · אומדן להשוואה בלבד — / 1K טוקנים
תצורהמחיר וידאוטבלת תעריפים—כמות חזויה—יחידת חיובלכל שניית וידאותנאי חיובלא הוגדר תנאי נוסף במפתח תמחור זה.חיוב
פלט · מחיר וידאו · אומדן להשוואה בלבד $0.26 לכל שניית וידאו
תצורהתמונת ייחוסטבלת תעריפים—כמות חזויה—יחידת חיובלכל תמונת ייחוסתנאי חיוב—חיוב
קלט · תמונת ייחוס · אומדן להשוואה בלבד $0.08 לכל תמונת ייחוס
תצורהעלות יצירה משוערתטבלת תעריפים—כמות חזויהאומדן ליצירה אחתיחידת חיוב—תנאי חיוב—חיוב
פלט · עלות יצירה משוערת · אומדן להשוואה בלבד $1.3 אומדן לפני היצירה

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

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

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

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

הפניות למחירי תצורות וידאו

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

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

תצורהתנאי חיובחיוב
תצורהמחיר וידאותנאי חיובלא הוגדר תנאי נוסף במפתח תמחור זה.חיוב
פלט · מחיר וידאו $0.26 לכל שניית וידאו

מחיר הייחוס שפורסם עבור התצורה המוצגת. החיובים הסופיים נקבעים לפי התצורה שחויבה בפועל.

תצורהתמונות עזר מעבר לחמש הראשונותתנאי חיובלא הוגדר תנאי נוסף במפתח תמחור זה.חיוב
קלט · תמונות עזר מעבר לחמש הראשונות $0.08 לכל תמונה

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

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

Ailoot Ultra · וידאו

set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"minimax/hailuo-3","prompt":"A serene mountain landscape at sunset","resolution":"2K"}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n  --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n

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

Ailoot Ultra · וידאו

כתובות חתומות לתוכן שבבעלותכם

בדיקת מצב המשימה
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error "$(cat status-url.txt)" \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n
קריאות תוכן נוספות
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n    urls.append((str(i),u))\nfor label,path in urls:\n    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n    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')\n    target=Path('owned-'+label+'.bin')\n    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)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n
שמירת כל התוצאות שהושלמו

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

יש לשמור כל פלט ממשי שבבעלותכם ואת המטא־נתונים המדודים שהוחזרו איתו.

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

503 result_pending_check + originalid + X-Should-Retry:false; אין לשלוח שוב את הבקשה המקורית

שדות התגובה
שדהסוגמשמעות
שדהindexסוגintegerמשמעותמיקום הווידאו הזה ברשימת הפלטים, בספירה המתחילה מאפס.
שדהcontent_urlסוגstringמשמעותכתובת URL חתומה להורדת הווידאו שהושלם ב־HTTPS.
שדהsha256סוגstring | nullמשמעותתקציר SHA-256 של בתי הווידאו המקורי; null אם אינו זמין.
שדהsize_bytesסוגinteger | nullמשמעותגודל קובץ הווידאו המקורי בבתים; null אם אינו זמין.
שדהduration_msסוגinteger | nullמשמעותמשך הווידאו המדוד באלפיות שנייה; null אם אינו זמין.
שדהwidthסוגinteger | nullמשמעותרוחב הווידאו בפיקסלים; null אם אינו זמין.
שדהheightסוגinteger | nullמשמעותגובה הווידאו בפיקסלים; null אם אינו זמין.
שדהvideo_codecסוגstring | nullמשמעותמזהה מקודד הווידאו; null אם לא נרשם.
שדהhas_audioסוגboolean | nullמשמעותהאם הווידאו מכיל רצועת אודיו; null אם לא נמדד.
שדהaudio_codecסוגstring | nullמשמעותמזהה מקודד האודיו; null כאשר לא נרשם מזהה.
שגיאות והשלבים הבאים
תגובהתנאיהשלב הבא
תגובה⁦404⁩ · not_found_errorתנאיהגישה לווידאו אינה זמינה, או שמזהה הווידאו הזה לא נמצא.השלב הבאיש לבדוק את הגישה לווידאו. עבור וידאו קיים, יש להשתמש במזהה הציבורי המקורי שלו ובאותו מפתח API.
תגובה⁦401⁩ · authentication_errorתנאימפתח ה־API אינו תואם לחשבון המאומת.השלב הבאיש לבדוק את מפתח ה־API ואת הגישה לחשבון לפני השליחה.
תגובה⁦400⁩ · invalid_request_errorתנאילא ניתן היה לקרוא את הבקשה, או שאינדקס ההורדה אינו תקף.השלב הבאיש לתקן את גוף הבקשה. להורדה, יש לבחור אינדקס פלט שהוחזר על ידי המשימה המקורית.
תגובה⁦422⁩ · price_unavailableתנאילא ניתן לתמחר את תצורת הווידאו שנבחרה.השלב הבאיש לבחור תצורת וידאו נתמכת ולהשלים את האפשרויות הנדרשות בה לפני שליחת בקשה מתוקנת.
תגובה⁦422⁩ · invalid_request_errorתנאיקלט וידאו או משימת המשך מקורית אינם תקפים.השלב הבאיש להשתמש בקלטי HTTPS תקפים. להמשך, יש להשתמש במזהה הציבורי של הווידאו המקורי שלכם שהושלם, עם אותו מפתח API.
תגובה⁦402⁩ · billing_errorתנאיהיתרה הזמינה או המגבלות אינן מאפשרות לשריין סכום.השלב הבאיש לבדוק את היתרה הזמינה ואת המגבלות לפני שליחת בקשה חדשה.
תגובה⁦503⁩ · server_errorתנאיאימות הווידאו, האחסון או הגישה לשירות אינם זמינים זמנית.השלב הבאיש להמתין לזמינות השירות. אם כבר יש לכם מזהה וידאו, יש לבדוק את המשימה המקורית הזו במקום ליצור וידאו נוסף.
תגובה⁦503⁩ · result_pending_checkתנאייש לבדוק את תוצאת הווידאו המקורית ואת החיוב.השלב הבאיש לשמור את מזהה הווידאו שהוחזר ולבדוק את המשימה הזו. אין לשלוח בקשת יצירה חלופית בזמן הבדיקה.
תגובה⁦503⁩ · owned_result_unavailableתנאיהורדת הווידאו הקיים אינה זמינה זמנית.השלב הבאיש לבדוק את אותה משימת וידאו בהמשך ולהוריד את הפלט הקיים שלה. יצירה חדשה יוצרת פעולה נפרדת.
תגובה⁦409⁩ · video_not_readyתנאיתוכן הווידאו לא פורסם.השלב הבאיש לבדוק את הסטטוס של המשימה המקורית. יש להוריד לאחר שהיא מדווחת completed; אם היא מדווחת failed, יש לפעול לפי ההודעה שלה על בדיקת החיוב.

כינויים

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

Ailoot Ultra minimax/hailuo-3

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

השתמשו בנתיבי השיטות המוצגים למעלה.

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

minimax/hailuo-3

", "method_identity": { "effective_request_model_id": "minimax/hailuo-3", "fmt": "videos", "http": "POST", "path": "/v1/videos", "request_model_id": "minimax/hailuo-3", "route_label": "Ultra" }, "method_key": "Ultra|videos|/v1/videos|minimax%2Fhailuo-3", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "התעריפים המוצגים מספקים אומדן לעלות לפני היצירה. החיוב הסופי מחושב לפי העלות שנרשמה עבור היצירה המקורית. משך הפלט שנמדד והכמויות החזויות אינם הכמות הסופית לחיוב.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "יש לשמור כל פלט ממשי שבבעלותכם ואת המטא־נתונים המדודים שהוחזרו איתו.", "defaults": { "aspect_ratio": null, "duration": null, "generate_audio": "endpoint capability flag when published; omitted unknown stays unknown; never guarantees audio track", "resolution": null, "seed": null, "size": null, "wire_omissions_preserved": true }, "errors": [ { "condition": "הגישה לווידאו אינה זמינה, או שמזהה הווידאו הזה לא נמצא.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "יש לבדוק את הגישה לווידאו. עבור וידאו קיים, יש להשתמש במזהה הציבורי המקורי שלו ובאותו מפתח API.", "type": "not_found_error" }, { "condition": "מפתח ה־API אינו תואם לחשבון המאומת.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "יש לבדוק את מפתח ה־API ואת הגישה לחשבון לפני השליחה.", "type": "authentication_error" }, { "condition": "לא ניתן היה לקרוא את הבקשה, או שאינדקס ההורדה אינו תקף.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "יש לתקן את גוף הבקשה. להורדה, יש לבחור אינדקס פלט שהוחזר על ידי המשימה המקורית.", "type": "invalid_request_error" }, { "condition": "לא ניתן לתמחר את תצורת הווידאו שנבחרה.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "יש לבחור תצורת וידאו נתמכת ולהשלים את האפשרויות הנדרשות בה לפני שליחת בקשה מתוקנת.", "type": "price_unavailable" }, { "condition": "קלט וידאו או משימת המשך מקורית אינם תקפים.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "יש להשתמש בקלטי HTTPS תקפים. להמשך, יש להשתמש במזהה הציבורי של הווידאו המקורי שלכם שהושלם, עם אותו מפתח API.", "type": "invalid_request_error" }, { "condition": "היתרה הזמינה או המגבלות אינן מאפשרות לשריין סכום.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "יש לבדוק את היתרה הזמינה ואת המגבלות לפני שליחת בקשה חדשה.", "type": "billing_error" }, { "condition": "אימות הווידאו, האחסון או הגישה לשירות אינם זמינים זמנית.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "יש להמתין לזמינות השירות. אם כבר יש לכם מזהה וידאו, יש לבדוק את המשימה המקורית הזו במקום ליצור וידאו נוסף.", "type": "server_error" }, { "code": "result_pending_check", "condition": "יש לבדוק את תוצאת הווידאו המקורית ואת החיוב.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "יש לשמור את מזהה הווידאו שהוחזר ולבדוק את המשימה הזו. אין לשלוח בקשת יצירה חלופית בזמן הבדיקה.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "הורדת הווידאו הקיים אינה זמינה זמנית.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "יש לבדוק את אותה משימת וידאו בהמשך ולהוריד את הפלט הקיים שלה. יצירה חדשה יוצרת פעולה נפרדת.", "type": "server_error" }, { "condition": "תוכן הווידאו לא פורסם.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "יש לבדוק את הסטטוס של המשימה המקורית. יש להוריד לאחר שהיא מדווחת completed; אם היא מדווחת failed, יש לפעול לפי ההודעה שלה על בדיקת החיוב.", "type": "video_not_ready" } ], "hints": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "ignored_fields": [], "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; אין לשלוח שוב את הבקשה המקורית" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "minimax/hailuo-3" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "יש לספק prompt כטקסט ו־duration בשניות שלמות. יש לבחור רזולוציה נתמכת ובמידת הצורך גם יחס גובה־רוחב.", "required": [ "model", "prompt", "duration" ], "required_material": "הנחיה כתובה." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "minimax/hailuo-3" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "frame_images הוא מערך. כל אובייקט פריים כולל type, image_url ו־frame_type; השדה image_url מכיל url. יש להגדיר type לערך image_url. יש להשתמש ב־first_frame, עם last_frame אופציונלי. כל תפקיד של פריים מופיע פעם אחת לכל היותר. יש לספק כתובת URL ציבורית של תמונה ב־HTTPS לכל פריים. יש להשתמש בתמונות פריימים או בתמונות עזר בבקשה אחת; אין לשלב את שתיהן. יש לבחור רזולוציה נתמכת ובמידת הצורך גם יחס גובה־רוחב.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "הנחיה כתובה ותמונה של הפריים הראשון." }, { "mode": "Reference to video", "model": { "enum": [ "minimax/hailuo-3" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "input_references הוא מערך אובייקטים. יש להגדיר type לערך image_url, video_url, audio_url ולהשתמש בשדה המתאים המכיל url. יש להשתמש בכתובות HTTPS ציבוריות. יש להשמיט frame_images כדי לבחור מצב חומרי עזר. האומדן כולל את הרכיב המוצג לכל תמונה רק עבור תמונות עזר מעבר לחמש הראשונות. החיוב הסופי נקבע לפי התצורה שחויבה בפועל. אין לשלב תמונות עזר עם תמונות פריימים. יש לבחור רזולוציה נתמכת ובמידת הצורך גם יחס גובה־רוחב.", "required": [ "model", "prompt", "duration", "input_references" ], "required_material": "הנחיה כתובה וחומרי עזר נתמכים מסוג תמונה, וידאו ואודיו." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "מיקום הווידאו הזה ברשימת הפלטים, בספירה המתחילה מאפס.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "כתובת URL חתומה להורדת הווידאו שהושלם ב־HTTPS.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "תקציר SHA-256 של בתי הווידאו המקורי; null אם אינו זמין.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "גודל קובץ הווידאו המקורי בבתים; null אם אינו זמין.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "משך הווידאו המדוד באלפיות שנייה; null אם אינו זמין.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "רוחב הווידאו בפיקסלים; null אם אינו זמין.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "גובה הווידאו בפיקסלים; null אם אינו זמין.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "מזהה מקודד הווידאו; null אם לא נרשם.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "האם הווידאו מכיל רצועת אודיו; null אם לא נמדד.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "מזהה מקודד האודיו; null כאשר לא נרשם מזהה.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "כתובות חתומות לתוכן שבבעלותכם", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "minimax/hailuo-3" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "minimax/hailuo-3" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "2K" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "2K" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false, true ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "המפתחות האלה מתארים כל אובייקט פריים; image_url מכיל רק url. יש להשמיט frame_images בבקשה המבוססת על טקסט בלבד.", "content": "מערך אובייקטים של פריימים. כל אובייקט כולל type=image_url, שדה image_url המכיל url, ו־frame_type. יש להשתמש בכתובת URL של תמונה ב־HTTPS ולהגדיר frame_type לערך first_frame או last_frame. כל תפקיד של פריים מופיע פעם אחת לכל היותר.", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 2, "max_items": 2, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "input_references", "required": false, "schema": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "type": { "const": "video_url" }, "video_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" } }, "required": [ "type", "video_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "type": { "const": "video_url" }, "video_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" } }, "required": [ "type", "video_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "model": { "const": "minimax/hailuo-3" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "2K" ] }, "seed": false, "session_id": { "maxLength": 256, "type": "string" }, "size": false, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist.", "Frame images plus image references are rejected because mixed additive input count is unproved; pure frame or pure reference mode remains separately priced." ] }, "unsupported": [ "size", "seed", "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image", "audio", "video" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.26", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.26", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "quoted_unit": "per reference image" }, "label": "reference image", "units": [ { "amount": "0.08", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "reference_images", "label": "reference image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "public_unit_label": "per reference image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "reference_images" } ] }, { "basis": "אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "עלות יצירה משוערת", "units": [ { "amount": "1.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.3", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{\"aspect_ratio\":\"16:9\",\"duration\":8,\"model\":\"minimax/hailuo-3\",\"prompt\":\"A serene mountain landscape at sunset\",\"resolution\":\"2K\"}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · create video", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n 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')\n target=Path('owned-'+label+'.bin')\n 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)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image", "audio", "video" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.26", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.26", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "quoted_unit": "per reference image" }, "label": "reference image", "units": [ { "amount": "0.08", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "reference_images", "label": "reference image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "public_unit_label": "per reference image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "reference_images" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "1.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.3", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "minimax/hailuo-3", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.26", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.26", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.08", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "reference_images", "label": "reference image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "public_unit_label": "per reference image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "reference_images" }, { "amount": "1.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.3", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } } ], "model_id": "minimax/hailuo-3", "nativeProvenance": { "input_facts_canonical_sha256": "1d0f4be0ace6bcb7fe47fdee5921062eebae071bf2a6b816406309f286222bd1", "input_html_sha256": "5c6c5ddda29e6f9c51e457dcb37f3389be6bb8f7e30c287920cf00bc9e9d385d", "private_audit_sha256": "34a48df0e6d24349d61896dfba6d88458e491f282383969aef9c964926590e15", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/he/minimax-hailuo-3/", "description": "MiniMax H3 יוצר וידאו קצר עם אודיו סטריאופוני מובנה מטקסט, מתמונות פריים או מייחוסים רב־מודאליים. הוא תומך ביצירה באמצעות פריים ראשון ואחרון, בעריכה המונחית באמצעות ייחוסים ובקשרים של תנועה או קול, עם פלט באורך 4–15 שניות ותהליך נפרד ליצירה מחדש ב־2K.", "locale": "he", "md_url": "https://ailoot.ai/models/he/minimax-hailuo-3/index.md", "title": "MiniMax: H3 — Ailoot", "url": "https://ailoot.ai/models/he/minimax-hailuo-3/" }, "rawModel": { "about": "תוצאה אחת של תמונה וקול מבריף רב־מודאלי\n\nMiniMax H3 הוא מערכת הווידאו הרב־מודאלית הכוללת של MiniMax. הוא מפרש יחד טקסט, תמונות, וידאו ואודיו, ואז יוצר וידאו עם קול סטריאופוני מובנה. היצרן מציג אותו לעבודה יצירתית קצרה, כגון המחשות מוצר, פרסום, כרזות מונפשות וקונספטים לכותרות סרטים, שבה היחסים בין נכסי הייחוס חשובים לא פחות מתיאור הסצנה.\n\nהמערכת המתועדת מפיקה וידאו באורך 4–15 שניות בקצב 24 פריימים לשנייה עם אודיו סטריאופוני ב־32 kHz. יצירת H3-Base פועלת ב־768p; תהליך העבודה המלא של 2K יוצר מחדש את התוצאה באמצעות ההקשר הרב־מודאלי המקורי. זהו יותר משינוי גודל רגיל: השלב השני משתמש שוב במודל ובהקשר המקור כדי לשחזר פרטים עדינים. ל־H3 Max ול־H3-Context-IR יש תפקידים ומגבלות נפרדים.\n\nיצירה מטקסט ובהנחיית פריימים\n\nקלט של טקסט בלבד מתאר את ציר הזמן המלא של התמונה והקול. תמונה ראשונה מעגנת את הפתיחה, תמונה אחרונה מעגנת את הסיום, ושתי תמונות יכולות להגדיר את שניהם. לשוט מפריים ראשון, התחילו בקומפוזיציה ובזהות הגלויות בתמונת הסטילס, ואז תארו את הפעולה המתפתחת ממנה. למעבר מפריים ראשון לפריים אחרון, תארו את התנועה הנראית המחברת בין שני המצבים במקום לחזור על שני תיאורי תמונות שאינם קשורים.\n\nבריף מוצר מעשי יכול להגדיר אריזה סגורה בפריים הפתיחה, את היד שפותחת אותה, תנועת מצלמה עדינה ואת המצב הסופי שאליו יש להגיע. שמרו בפריימים שסופקו על צורת העצם, מיקום התווית והתאורה. יצירה בהנחיית פריימים ויצירה בהנחיית ייחוסים הן מצבי קלט נפרדים; ממשק היצרן אינו משלב תפקידי פריים ראשון ואחרון עם תפקידי מדיית ייחוס בבקשה אחת.\n\nיצירה ועריכה בהנחיית ייחוסים\n\nמצב הייחוסים מקבל טקסט עם תמונות, קליפי וידאו וקליפי אודיו. הגדירו מה כל מקור תורם: מראה של דמות, מיקום, תנועת מצלמה, המבנה הזמני של קליפ מקור או קול. סרטון המשמש רק לתנועת מצלמה שונה מסרטון שאותו צריך לערוך או להמשיך בפועל. ציינו את היחס הזה במפורש.\n\nמדריך הייחוסים של היצרן מפריד בין הגדרות נושאים, סיכום משימה, ניתוח שימור, תיאור שוט מפורט, סביבת קול כוללת ומוזיקת רקע המיועדת לקהל בלבד. הוא מבחין בין שימור תוכן גלוי לבין העברת מאפיינים או ייחוס סגנוני רחב. באודיו, העתקת אות שונה מהתייחסות לגון, לקצב או לאופן הביצוע. שמרו על התפקידים האלה לאורך הבריף.\n\nלסצנה המבוססת על ייחוסים, ספקו תמונת דמות, ייחוס קצר לתנועת מצלמה וייחוס קולי, ואז תארו היכן כל אחד מהם צריך להשפיע על שוט היעד. ציינו אילו פרטי לבוש, סביבה או עצמים חייבים להישאר מזוהים. השוו את הקליפ המוגמר לדרישות האלה, לרבות רציפות התנועה והקשר בין הדובר הנראה לקול שנשמע.\n\nדיבור, קול ותזמון השוט\n\nH3 ממדל יחד דיאלוג, קולות פיזיים, אווירה ומוזיקה. כרטיס המודל מתעד תמיכה יציבה בדיאלוג בערבית, בסינית, באנגלית, בצרפתית, בגרמנית, באיטלקית, ביפנית, בקוריאנית, בפורטוגזית, ברוסית ובספרדית; התמיכה בשפות אחרות מתוארת כמשתנה. ספקו את המילים המדוברות המדויקות ואת השפה, עם זהות דובר יציבה בין שוטים.\n\nמדריכי כתיבת ההנחיות של היצרן משתמשים באנגלית בחלקים התיאוריים, תוך שמירה על הדיאלוג והטקסט הגלוי בשפתם המקורית. תוכן מדובר משתמש ב־`[Language] ...`, כאשר זהות הדובר ותיאור הקול מופיעים מחוץ לבלוק. הבחינו בין דיבור פיזי לבין קריינות מחוץ לפריים, וציינו מתי שורה נמשכת מעבר לחיתוך או נקטעת בסיום. שמרו גם על הטקסט הגלוי בדיוק. התאימו את כמות הדיבור למשך שנבחר ובדקו יחד את המילים המוצגות ואת השורה הנשמעת.\n\nתארו תנועת מצלמה כפעולה, לרבות הטווח והמהירות כאשר הם חשובים. מספרו שוטים לפי סדר הניגון ושמרו את זמני החיתוך בתוך משך הסרטון. הפרידו בין קולות הסצנה, כגון צעדים או סגירת דלת, לבין מוזיקת רקע שרק הקהל שומע. בחירות אלה מקלות לפרש תוכנית שוטים קצרה ולבדוק אותה מול תוצאתה.\n\nהכנת הקלט ומגבלות מספריות\n\nסכמת היצירה הנוכחית מחייבת טקסט שאינו ריק בכל מצב, באורך של עד 7,000 תווים לכל פריט טקסט. תמונות יכולות להיות בפורמט JPG, JPEG, PNG, WebP, HEIC או HEIF, עד 30 MB כל אחת, עם כל צלע בין 256 ל־5,760 פיקסלים ויחס ממדים בין 0.4 ל־2.5. קלט פריימים מאפשר תמונת פתיחה אחת ותמונת סיום אחת; מצב הייחוסים מאפשר עד תשע תמונות ייחוס.\n\nוידאו לייחוס יכול לכלול עד שלושה קליפים בפורמט MP4 או MOV, כל אחד באורך 2–15 שניות ובאורך כולל שאינו עולה על 15 שניות. קליפ יכול להיות בגודל של עד 50 MB; קידוד הווידאו שלו הוא H.264 או H.265, עם אודיו AAC או MP3, צלעות שבין 256 ל־5,760 פיקסלים, יחסי ממדים שבין 0.4 ל־2.5 וקצב פריימים שבין 23.976 ל־60. אודיו לייחוס תומך בעד שלושה קליפים בפורמט WAV או MP3, עד 15 MB כל אחד, כל אחד באורך 2–15 שניות ובאורך כולל שאינו עולה על 15 שניות. כרטיס המודל מגביל קלטי ייחוס מעורבים ל־12 קבצים. מגבלת גוף הבקשה המתועדת היא 64 MB, בנפרד מהמגבלות לכל קובץ.\n\nבחרו רק ייחוסים שתורמים לבריף והבהירו את התרומה של כל אחד. תצוגה ברורה של הנושא שימושית יותר מכמה תצוגות סותרות ללא הסבר. שמרו על סדר הייחוסים, חתכו חומר לא רלוונטי בלי להסיר הקשר הכרחי לסצנה, ובדקו שקליפי מקור קצרים כוללים את הפעולה או מאפיין הקול שהתבקשו.\n\nמבנה הפלט והמערכת המלאה\n\nממשק H3 של היצרן מציע 768P ו־2K. יצירה מטקסט בלבד מחייבת יחס ממדים מוגדר: 21:9, 16:9, 4:3, 1:1, 3:4 או 9:16. יצירה מפריים ראשון ואחרון מקבלת את יחס הממדים שלה מתמונת הקלט; יצירה מייחוסים יכולה להשתמש ביחס מותאם אוטומטית או מפורש. משך הפלט במספר שלם הוא 4–15 שניות.\n\nכרטיס המודל מבחין בין H3-Context-IR, שמפרש ומעשיר את הבריף, H3-Base, שיוצר תוכן של תמונה וקול, ו־H3-Regenerate-2K, שיוצר את התוצאה ברזולוציה הגבוהה יותר. נקודות הביקורת הבסיסיות ששוחררו מפרידות בין משימות בהנחיית פריימים לבין משימות עם מכלול ייחוסים. רכיבי ההקשר והיצירה מחדש נפרדים מאותם משקלי בסיס, ולכן שם של נקודת ביקורת פתוחה לבדו אינו מעיד על התנהגות המערכת כולה.\n\nתהליך היצירה של היצרן הוא אסינכרוני. ממשק שאילתות המשימות שלו מאחזר משימות משבעת הימים האחרונים. שמרו את מזהה המשימה עד שמתקבלת תוצאת הווידאו בפועל, ואז שמרו את הקליפ במקום לשמור רק כתובת הורדה מוגבלת בזמן. בדקו זהות חזותית, טקסט קטן, אינטראקציות בין עצמים, תוכן מדובר ותזמון קול בגודל הצפייה המיועד. היצרן מציין שהבנה רב־מודאלית ופרטים חזותיים עדינים עדיין נמצאים בשיפור מתמשך; בריף מפורט והשוואה למקורות נשארים מרכזיים להשגת תוצאה שימושית.", "alias_of": null, "aliases": [], "author": "MiniMax", "available": null, "canonical_model": "minimax/hailuo-3", "capabilities": { "context_length": 0, "manufacturer_input": [ "text", "image", "video", "audio" ], "manufacturer_output": [ "video" ] }, "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "1.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.3", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ], "summary": "התמחור המלא של התצורה מופיע בפרטים." } ], "ctx": null, "declared_tariff_references": [ { "client_selectable": false, "key": "ffcc346d33bca9e66b22f181", "label": "הפניות למחירי תצורות וידאו", "profiles": [ { "basis": "מחיר הייחוס שפורסם עבור התצורה המוצגת. החיובים הסופיים נקבעים לפי התצורה שחויבה בפועל.", "dimensions": { "conditions": "לא הוגדר תנאי נוסף במפתח תמחור זה." }, "label": "מחיר וידאו", "units": [ { "amount": "0.26", "amount_unit": "usd_per_video_second", "billing_input": false, "key": "video_second", "label": "Video price", "public_unit_label": "per video second", "quantity": 1, "rate_role": "typed_video_second_reference", "side": "out", "unit": "video_second" } ] }, { "basis": "חמש תמונות העזר הראשונות חינמיות; התעריף המפורט לכל תמונה חל מעבר לחמש הראשונות. זוהי הפניה למחיר שפורסם עבור התצורה המוצגת. החיובים הסופיים נקבעים לפי התצורה שחויבה בפועל.", "dimensions": { "conditions": "לא הוגדר תנאי נוסף במפתח תמחור זה." }, "label": "תמונות עזר מעבר לחמש הראשונות", "units": [ { "amount": "0.08", "amount_unit": "usd_per_image", "billing_input": false, "key": "input_image", "label": "Reference images after the first five", "public_unit_label": "per image", "quantity": 1, "rate_role": "typed_video_image_reference", "side": "in", "unit": "image" } ] } ] } ], "entity_type": "model", "formats": [ "videos" ], "id": "minimax/hailuo-3", "input": [ "text", "image", "audio", "video" ], "kind": "video", "max_out": null, "methods": [ { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "התעריפים המוצגים מספקים אומדן לעלות לפני היצירה. החיוב הסופי מחושב לפי העלות שנרשמה עבור היצירה המקורית. משך הפלט שנמדד והכמויות החזויות אינם הכמות הסופית לחיוב.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "יש לשמור כל פלט ממשי שבבעלותכם ואת המטא־נתונים המדודים שהוחזרו איתו.", "defaults": { "aspect_ratio": null, "duration": null, "generate_audio": "endpoint capability flag when published; omitted unknown stays unknown; never guarantees audio track", "resolution": null, "seed": null, "size": null, "wire_omissions_preserved": true }, "errors": [ { "condition": "הגישה לווידאו אינה זמינה, או שמזהה הווידאו הזה לא נמצא.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "יש לבדוק את הגישה לווידאו. עבור וידאו קיים, יש להשתמש במזהה הציבורי המקורי שלו ובאותו מפתח API.", "type": "not_found_error" }, { "condition": "מפתח ה־API אינו תואם לחשבון המאומת.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "יש לבדוק את מפתח ה־API ואת הגישה לחשבון לפני השליחה.", "type": "authentication_error" }, { "condition": "לא ניתן היה לקרוא את הבקשה, או שאינדקס ההורדה אינו תקף.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "יש לתקן את גוף הבקשה. להורדה, יש לבחור אינדקס פלט שהוחזר על ידי המשימה המקורית.", "type": "invalid_request_error" }, { "condition": "לא ניתן לתמחר את תצורת הווידאו שנבחרה.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "יש לבחור תצורת וידאו נתמכת ולהשלים את האפשרויות הנדרשות בה לפני שליחת בקשה מתוקנת.", "type": "price_unavailable" }, { "condition": "קלט וידאו או משימת המשך מקורית אינם תקפים.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "יש להשתמש בקלטי HTTPS תקפים. להמשך, יש להשתמש במזהה הציבורי של הווידאו המקורי שלכם שהושלם, עם אותו מפתח API.", "type": "invalid_request_error" }, { "condition": "היתרה הזמינה או המגבלות אינן מאפשרות לשריין סכום.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "יש לבדוק את היתרה הזמינה ואת המגבלות לפני שליחת בקשה חדשה.", "type": "billing_error" }, { "condition": "אימות הווידאו, האחסון או הגישה לשירות אינם זמינים זמנית.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "יש להמתין לזמינות השירות. אם כבר יש לכם מזהה וידאו, יש לבדוק את המשימה המקורית הזו במקום ליצור וידאו נוסף.", "type": "server_error" }, { "code": "result_pending_check", "condition": "יש לבדוק את תוצאת הווידאו המקורית ואת החיוב.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "יש לשמור את מזהה הווידאו שהוחזר ולבדוק את המשימה הזו. אין לשלוח בקשת יצירה חלופית בזמן הבדיקה.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "הורדת הווידאו הקיים אינה זמינה זמנית.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "יש לבדוק את אותה משימת וידאו בהמשך ולהוריד את הפלט הקיים שלה. יצירה חדשה יוצרת פעולה נפרדת.", "type": "server_error" }, { "condition": "תוכן הווידאו לא פורסם.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "יש לבדוק את הסטטוס של המשימה המקורית. יש להוריד לאחר שהיא מדווחת completed; אם היא מדווחת failed, יש לפעול לפי ההודעה שלה על בדיקת החיוב.", "type": "video_not_ready" } ], "hints": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "ignored_fields": [], "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; אין לשלוח שוב את הבקשה המקורית" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "minimax/hailuo-3" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "יש לספק prompt כטקסט ו־duration בשניות שלמות. יש לבחור רזולוציה נתמכת ובמידת הצורך גם יחס גובה־רוחב.", "required": [ "model", "prompt", "duration" ], "required_material": "הנחיה כתובה." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "minimax/hailuo-3" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "frame_images הוא מערך. כל אובייקט פריים כולל type, image_url ו־frame_type; השדה image_url מכיל url. יש להגדיר type לערך image_url. יש להשתמש ב־first_frame, עם last_frame אופציונלי. כל תפקיד של פריים מופיע פעם אחת לכל היותר. יש לספק כתובת URL ציבורית של תמונה ב־HTTPS לכל פריים. יש להשתמש בתמונות פריימים או בתמונות עזר בבקשה אחת; אין לשלב את שתיהן. יש לבחור רזולוציה נתמכת ובמידת הצורך גם יחס גובה־רוחב.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "הנחיה כתובה ותמונה של הפריים הראשון." }, { "mode": "Reference to video", "model": { "enum": [ "minimax/hailuo-3" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "input_references הוא מערך אובייקטים. יש להגדיר type לערך image_url, video_url, audio_url ולהשתמש בשדה המתאים המכיל url. יש להשתמש בכתובות HTTPS ציבוריות. יש להשמיט frame_images כדי לבחור מצב חומרי עזר. האומדן כולל את הרכיב המוצג לכל תמונה רק עבור תמונות עזר מעבר לחמש הראשונות. החיוב הסופי נקבע לפי התצורה שחויבה בפועל. אין לשלב תמונות עזר עם תמונות פריימים. יש לבחור רזולוציה נתמכת ובמידת הצורך גם יחס גובה־רוחב.", "required": [ "model", "prompt", "duration", "input_references" ], "required_material": "הנחיה כתובה וחומרי עזר נתמכים מסוג תמונה, וידאו ואודיו." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "מיקום הווידאו הזה ברשימת הפלטים, בספירה המתחילה מאפס.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "כתובת URL חתומה להורדת הווידאו שהושלם ב־HTTPS.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "תקציר SHA-256 של בתי הווידאו המקורי; null אם אינו זמין.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "גודל קובץ הווידאו המקורי בבתים; null אם אינו זמין.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "משך הווידאו המדוד באלפיות שנייה; null אם אינו זמין.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "רוחב הווידאו בפיקסלים; null אם אינו זמין.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "גובה הווידאו בפיקסלים; null אם אינו זמין.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "מזהה מקודד הווידאו; null אם לא נרשם.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "האם הווידאו מכיל רצועת אודיו; null אם לא נמדד.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "מזהה מקודד האודיו; null כאשר לא נרשם מזהה.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "כתובות חתומות לתוכן שבבעלותכם", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "minimax/hailuo-3" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "minimax/hailuo-3" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "2K" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "2K" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false, true ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "המפתחות האלה מתארים כל אובייקט פריים; image_url מכיל רק url. יש להשמיט frame_images בבקשה המבוססת על טקסט בלבד.", "content": "מערך אובייקטים של פריימים. כל אובייקט כולל type=image_url, שדה image_url המכיל url, ו־frame_type. יש להשתמש בכתובת URL של תמונה ב־HTTPS ולהגדיר frame_type לערך first_frame או last_frame. כל תפקיד של פריים מופיע פעם אחת לכל היותר.", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 2, "max_items": 2, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "input_references", "required": false, "schema": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "type": { "const": "video_url" }, "video_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" } }, "required": [ "type", "video_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "type": { "const": "video_url" }, "video_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" } }, "required": [ "type", "video_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "model": { "const": "minimax/hailuo-3" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "2K" ] }, "seed": false, "session_id": { "maxLength": 256, "type": "string" }, "size": false, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist.", "Frame images plus image references are rejected because mixed additive input count is unproved; pure frame or pure reference mode remains separately priced." ] }, "unsupported": [ "size", "seed", "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image", "audio", "video" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.26", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.26", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "quoted_unit": "per reference image" }, "label": "reference image", "units": [ { "amount": "0.08", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "reference_images", "label": "reference image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "public_unit_label": "per reference image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "reference_images" } ] }, { "basis": "אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "עלות יצירה משוערת", "units": [ { "amount": "1.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.3", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{\"aspect_ratio\":\"16:9\",\"duration\":8,\"model\":\"minimax/hailuo-3\",\"prompt\":\"A serene mountain landscape at sunset\",\"resolution\":\"2K\"}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · create video", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n 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')\n target=Path('owned-'+label+'.bin')\n 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)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image", "audio", "video" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.26", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.26", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "quoted_unit": "per reference image" }, "label": "reference image", "units": [ { "amount": "0.08", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "reference_images", "label": "reference image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "public_unit_label": "per reference image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "reference_images" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "1.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.3", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "minimax/hailuo-3", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.26", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.26", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.08", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "reference_images", "label": "reference image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "public_unit_label": "per reference image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "reference_images" }, { "amount": "1.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.3", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "model_aliases": [ { "canonical_model_id": "minimax/hailuo-3", "request_model_id": "minimax/hailuo-3", "route_label": "Ultra" } ], "name": "MiniMax: H3", "price": { "estimate_only": true, "in": null, "in_label": null, "out": 1.3, "out_label": "estimate before generation", "scope_label": "Estimated generation cost", "sort_in": null, "sort_out": 1.3, "varies": false }, "pricing_profiles": [ { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "input_materials_additive": true, "resolution": "768P" }, "label": "Ultra", "units": [ { "amount": "0.16", "amount_unit": "usd_per_output_video_second", "conditions": { "input_materials_additive": true, "resolution": "768P" }, "key": "base", "label": "base", "profile_index": 0, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "input_materials_additive": true, "resolution": "2K" }, "label": "Ultra", "units": [ { "amount": "0.26", "amount_unit": "usd_per_output_video_second", "conditions": { "input_materials_additive": true, "resolution": "2K" }, "key": "base", "label": "base", "profile_index": 1, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "adds_to_output": true, "output_resolution": "768P" }, "label": "Ultra", "units": [ { "amount": "0.16", "amount_unit": "usd_per_input_video_second", "conditions": { "adds_to_output": true, "output_resolution": "768P" }, "key": "input_video", "label": "input video", "profile_index": 2, "quantity": "1", "rate_role": "binding_component_rate", "side": "in", "unit": "input_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "adds_to_output": true, "output_resolution": "2K" }, "label": "Ultra", "units": [ { "amount": "0.26", "amount_unit": "usd_per_input_video_second", "conditions": { "adds_to_output": true, "output_resolution": "2K" }, "key": "input_video", "label": "input video", "profile_index": 3, "quantity": "1", "rate_role": "binding_component_rate", "side": "in", "unit": "input_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "adds_to_output": true, "first_free_reference_images": 5, "only_additional_images_charged": true, "reference_audio_free": true }, "label": "Ultra", "units": [ { "amount": "0.08", "amount_unit": "usd_per_input_image", "conditions": { "adds_to_output": true, "first_free_reference_images": 5, "only_additional_images_charged": true, "reference_audio_free": true }, "key": "input_image", "label": "input image", "profile_index": 4, "quantity": "1", "rate_role": "binding_component_rate", "side": "in", "unit": "input_image" } ] }, { "applicability": { "client_selectable": false, "no_method_admission_claim": true, "scope": "supplier_tariff_reference" }, "dimensions": {}, "label": "Ailoot Ultra · Tariff components", "units": [ { "amount": "0.26", "amount_unit": "usd_per_exact_physical_unit", "basis": "output second", "billing_original_currency": "USD", "billing_original_rate": "0.26", "key": "duration_seconds", "label": "output second", "native_amount_usd_per_unit": "0.26", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" }, { "amount": "0.08", "amount_unit": "usd_per_exact_physical_unit", "basis": "reference image", "billing_original_currency": "USD", "billing_original_rate": "0.08", "key": "reference_images", "label": "reference image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "quantity": 1, "side": "in", "unit": "reference_image" } ] } ], "public_id": "minimax/hailuo-3", "short": "MiniMax H3 יוצר וידאו קצר עם אודיו סטריאופוני מובנה מטקסט, מתמונות פריים או מייחוסים רב־מודאליים. הוא תומך ביצירה באמצעות פריים ראשון ואחרון, בעריכה המונחית באמצעות ייחוסים ובקשרים של תנועה או קול, עם פלט באורך 4–15 שניות ותהליך נפרד ליצירה מחדש ב־2K." }, "renderer_schema": { "method_order": "Original DTO methods order; every exact route/format/path/caller survives.", "prices": "Original public DTO fields and original native display HTML; no flattened or normalized offers." }, "representation": "exact-public-dto-and-native-renderer-html", "representationNotes": { "current_reference": { "about_json_pointer": "/aboutHtml", "methods": [ { "contract_json_pointer": "/methods/0/rawMethod/contract", "html_json_pointer": "/methods/0/html", "method_ordinal": 0 } ], "role": "current-semantic-reference" }, "raw_input": { "examples_role": "historical-input-not-current-ready-examples", "json_pointers": [ "/rawModel", "/methods/0/rawMethod" ], "role": "historical-owner-input" }, "schema": "ailoot-native-model-representations-v1" }, "schema": "ailoot-static-model-facts-v1", "schema_version": 1, "shortText": "MiniMax H3 יוצר וידאו קצר עם אודיו סטריאופוני מובנה מטקסט, מתמונות פריים או מייחוסים רב־מודאליים. הוא תומך ביצירה באמצעות פריים ראשון ואחרון, בעריכה המונחית באמצעות ייחוסים ובקשרים של תנועה או קול, עם פלט באורך 4–15 שניות ותהליך נפרד ליצירה מחדש ב־2K.", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_json_sha256": "ead9d5291b5b974cf8f28a62abeee275e6f49e73222011f6daab2acf9ce06821", "renderer_sha256": "c36bd89b8b0dac234af52bf68530df83530b908ec7a9f2e1de2483fe236ae910" }, "sourceRevision": "ea23cadc67798208ad0e7f18384f8682855fb1e26ee0848ac08ed946be12497c" }