{ "aboutHtml": "

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

צרו סצנה או תנו הוראת עריכה

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

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

שלבו והכינו תמונות ייחוס

פרופיל היצרן המדויק מקבל אחד עד עשרה ייחוסים, המסופקים ככתובות URL של תמונות או כנתוני תמונה מקודדים. כל אחד חייב להיות בגודל של לפחות 256×256 פיקסלים ולא יותר מ־16 מגה־פיקסלים. נקבו בייחוס לפי מיקומו או לפי התוכן הגלוי בו, ואז הסבירו את תפקידו: האדם מ־Image 1, הז'קט מ־Image 2 והחדר מ־Image 3. תמונת ייחוס היא מקור למידע חזותי, ולא הוראה להעתיק כל פרט לא קשור שהיא מכילה.

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

מקמו רכיבים באמצעות תיבות תוחמות

הנחיית פריסה משלבת כיתוב עם מערך JSON של שורות רכיבים. הכיתוב נוקב ברכיב באמצעות סמן כגון <cup_1>; השורה מכילה id, bbox ו־desc. הקואורדינטות הן מספרים שלמים בין 0 ל־1000 בסדר [top, left, bottom, right], הנמדדים מהפינה השמאלית העליונה. למשל, [0, 0, 500, 500] מתאר את הרבע השמאלי העליון בלי קשר לממדי התמונה בפיקסלים. השתמשו ביחס הממדים שעבורו תוכננה הפריסה, משום שרשת הקואורדינטות הזו נמתחת עם המסגרת.

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

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

עיגון במידע, דרגות פלט ורשומות שימושיות

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

חמש דרגות הרזולוציה הן 768sq, 1k, 1.5k, 2k ו־4k, עם 1k כברירת מחדל. הן מייצגות דרגות של שטח פיקסלים שווה, ולכן הרוחב והגובה המדויקים תלויים ביחס שנבחר. חמישה עשר יחסים קבועים נעים מ־21:9 דרך פורמטים ריבועיים ולאורך ועד 9:21. הפרופיל של המודל הזה שולט בגודל באמצעות יחס ורזולוציה; הוא אינו חושף את שדות seed, width או height המשמשים בפרופילי הבקשה של FLUX.2. בורר הגרסה המתועד שלו מציין כיום מהדורה מתעדכנת, ולא קובע התאמה למשקלי ספק מתוארכים.

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

", "aboutText": "FLUX 3 Image הוא מודל ליצירת תמונות ולעריכתן של Black Forest Labs, עם שליטה מפורשת בקומפוזיציה. תיאור טקסטואלי יכול ליצור סצנה חדשה; תמונות שסופקו יכולות להגדיר נושא, סצנה לתיקון או כמה רכיבים לשילוב. תיבות תוחמות מאפשרות לבריף להגדיר היכן כל רכיב שייך ואילו חלקים בתמונה קיימת צריכים להשתנות. התוצאה היא תמונה, שבה יש לבדוק את הסצנה, הטקסט והפריסה שהתבקשו.\n\n### צרו סצנה או תנו הוראת עריכה\n\nלתמונה חדשה, תארו את הנושא, הפעולה או התנוחה, הסביבה, התאורה והמסגור. שימו ניסוח מדויק שיופיע בתמונה במירכאות וציינו היכן הוא מופיע. בריף מוצר מקורי יכול להציג ספל קמפינג אדום על משטח אבן בהיר, עם כותרת גדולה מעליו ואור בוקר רך שחושף את הידית. הגדירו את הקשר בין הכותרת, המוצר והרקע במקום להציע מילות סגנון שאינן קשורות.\n\nלעריכה, זהו את העצם המסוים ואת השינוי: צבעו מחדש את הספל, החליפו תווית, הזיזו דמות או שנו את סגנון הסצנה. עריכה בודדת אינה מחייבת תיבה שצוירה ידנית. תהליך העבודה המתועד מרחיב את ההוראה לפני היצירה ויכול לאתר את הרכיב ששמו צוין ולהוסיף תיבה אוטומטית. ההנחיה המורחבת שמוחזרת מתעדת את הפרשנות הזו, דבר שמועיל כאשר הוראה בוחרת בעצם הלא נכון או מוסיפה פרט לא רצוי.\n\n### שלבו והכינו תמונות ייחוס\n\nפרופיל היצרן המדויק מקבל אחד עד עשרה ייחוסים, המסופקים ככתובות URL של תמונות או כנתוני תמונה מקודדים. כל אחד חייב להיות בגודל של לפחות 256×256 פיקסלים ולא יותר מ־16 מגה־פיקסלים. נקבו בייחוס לפי מיקומו או לפי התוכן הגלוי בו, ואז הסבירו את תפקידו: האדם מ־Image 1, הז'קט מ־Image 2 והחדר מ־Image 3. תמונת ייחוס היא מקור למידע חזותי, ולא הוראה להעתיק כל פרט לא קשור שהיא מכילה.\n\nהגדרת יחס הממדים היא auto כברירת מחדל. במפרט הבקשה, ליחס שהתבקש בהנחיה יש עדיפות; אחרת הייחוס הראשון קובע את המסגור, עם פלט ריבועי כברירת גיבוי כשאין ייחוס או מבנה מבוקש שמספקים אותו. לשילוב תמונות, הציבו תחילה את ייחוס הסצנה הרצויה או בחרו את היחס במפורש. שמרו את תמונות המקור ואת סדרן עם התוצאה כדי שתיקון מאוחר ישתמש באותה נקודת פתיחה חזותית.\n\n### מקמו רכיבים באמצעות תיבות תוחמות\n\nהנחיית פריסה משלבת כיתוב עם מערך JSON של שורות רכיבים. הכיתוב נוקב ברכיב באמצעות סמן כגון ; השורה מכילה id, bbox ו־desc. הקואורדינטות הן מספרים שלמים בין 0 ל־1000 בסדר [top, left, bottom, right], הנמדדים מהפינה השמאלית העליונה. למשל, [0, 0, 500, 500] מתאר את הרבע השמאלי העליון בלי קשר לממדי התמונה בפיקסלים. השתמשו ביחס הממדים שעבורו תוכננה הפריסה, משום שרשת הקואורדינטות הזו נמתחת עם המסגרת.\n\nשורת עריכה משתמשת במקום זאת ב־from, ב־src_bbox וב־tgt_bbox לצד המזהה והתיאור. ref_image_0 פירושו התמונה הראשונה שסופקה. תיבות מקור ויעד תואמות מעגנות רכיב; תיבות שונות מזיזות אותו או משנות את גודלו. שורה חדשה ללא מקור יוצרת את התיאור שלה במיקום היעד ומאפשרת הוספות, החלפות או צביעה מחדש. שורת מקור ללא יעד מסירה את הרכיב. ציינו הוספות והסרות הן בהוראה הכתובה והן בשורות, ושמרו שורות עיגון לפרטים שחייבים להישאר במקומם.\n\nתנו לכיתוב תיבה משלו וצטטו את הניסוח המדויק ב־desc. תיבות מנחות מיקום וקנה מידה; הן אינן מסכות חיתוך, ולכן רכיב יכול לחרוג מהמלבן. היצרן מדווח שעצמים חדשים בתיבות של כ־40×25 פיקסלים לעיתים קרובות לא הופיעו בדוגמאות שלו. הקצו מספיק מרחב גלוי ובדקו את הגבולות שנערכו. פיקסלים מחוץ ליעד נשארים בדרך כלל יציבים, אך צללים, השתקפויות ותאורה סמוכה עדיין יכולים להשתנות.\n\n### עיגון במידע, דרגות פלט ורשומות שימושיות\n\nהפרופיל המתועד מפעיל עיגון במידע כברירת מחדל, ומאפשר לחיפוש ברשת ובתמונות לספק מידע ליצירה. אפשר להשביתו לבריף שצריך להשתמש רק בתיאור ובייחוסים שסופקו. לנושא מהעולם האמיתי, זהו בבירור את המיקום, האירוע או העצם והפרידו בין תוכן עובדתי לטיפול אמנותי. גם תמונות המבוססות על חיפוש דורשות השוואה לחומר סמכותי כאשר תווית, עצם או אירוע מתואר חייבים להיות מדויקים.\n\nחמש דרגות הרזולוציה הן 768sq, 1k, 1.5k, 2k ו־4k, עם 1k כברירת מחדל. הן מייצגות דרגות של שטח פיקסלים שווה, ולכן הרוחב והגובה המדויקים תלויים ביחס שנבחר. חמישה עשר יחסים קבועים נעים מ־21:9 דרך פורמטים ריבועיים ולאורך ועד 9:21. הפרופיל של המודל הזה שולט בגודל באמצעות יחס ורזולוציה; הוא אינו חושף את שדות seed, width או height המשמשים בפרופילי הבקשה של FLUX.2. בורר הגרסה המתועד שלו מציין כיום מהדורה מתעדכנת, ולא קובע התאמה למשקלי ספק מתוארכים.\n\nתהליך העבודה של היצרן מחזיר תמונה לאחר עיבוד אסינכרוני, יחד עם ההנחיה המורחבת. קישור הורדת התמונה החתום שלו תקף לשעה אחת. שמרו את התמונה עצמה, את ההנחיה הסופית ואת הייחוסים במקום להסתמך על קישור זמני. לנכס שנבדק, השוו את הטקסט שהתבקש, מיקום העצמים, זהות הייחוסים והאזור ששונה בגודל התצוגה המיועד. יצירה שהושלמה היא נקודת הפתיחה לבדיקת הדרישות החזותיות האלה.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "fc77d12bfa3c951878dcf0fafdeba57ed510f28bfa1e93a76e2233754b688400", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "he", "methods": [ { "html": "
•

Black Forest Labs: FLUX.3 Image

Black Forest Labs /black-forest-labs/flux-3-image

התחלה

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

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

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

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

צרו סצנה או תנו הוראת עריכה

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

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

שלבו והכינו תמונות ייחוס

פרופיל היצרן המדויק מקבל אחד עד עשרה ייחוסים, המסופקים ככתובות URL של תמונות או כנתוני תמונה מקודדים. כל אחד חייב להיות בגודל של לפחות 256×256 פיקסלים ולא יותר מ־16 מגה־פיקסלים. נקבו בייחוס לפי מיקומו או לפי התוכן הגלוי בו, ואז הסבירו את תפקידו: האדם מ־Image 1, הז'קט מ־Image 2 והחדר מ־Image 3. תמונת ייחוס היא מקור למידע חזותי, ולא הוראה להעתיק כל פרט לא קשור שהיא מכילה.

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

מקמו רכיבים באמצעות תיבות תוחמות

הנחיית פריסה משלבת כיתוב עם מערך JSON של שורות רכיבים. הכיתוב נוקב ברכיב באמצעות סמן כגון <cup_1>; השורה מכילה id, bbox ו־desc. הקואורדינטות הן מספרים שלמים בין 0 ל־1000 בסדר [top, left, bottom, right], הנמדדים מהפינה השמאלית העליונה. למשל, [0, 0, 500, 500] מתאר את הרבע השמאלי העליון בלי קשר לממדי התמונה בפיקסלים. השתמשו ביחס הממדים שעבורו תוכננה הפריסה, משום שרשת הקואורדינטות הזו נמתחת עם המסגרת.

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

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

עיגון במידע, דרגות פלט ורשומות שימושיות

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

חמש דרגות הרזולוציה הן 768sq, 1k, 1.5k, 2k ו־4k, עם 1k כברירת מחדל. הן מייצגות דרגות של שטח פיקסלים שווה, ולכן הרוחב והגובה המדויקים תלויים ביחס שנבחר. חמישה עשר יחסים קבועים נעים מ־21:9 דרך פורמטים ריבועיים ולאורך ועד 9:21. הפרופיל של המודל הזה שולט בגודל באמצעות יחס ורזולוציה; הוא אינו חושף את שדות seed, width או height המשמשים בפרופילי הבקשה של FLUX.2. בורר הגרסה המתועד שלו מציין כיום מהדורה מתעדכנת, ולא קובע התאמה למשקלי ספק מתוארכים.

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

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

Ailoot Ultra · תמונות POST /v1/images/generations
סוגי קלט
text, image
סוגי פלט
image
שדהסוגדרישהערכים ומגבלותברירת מחדל
שדהmodelסוגstringדרישהחובהערכים ומגבלות
black-forest-labs/flux-3-image
ברירת מחדל—
שדהpromptסוגstringדרישהחובהערכים ומגבלות
אורך מזערי: ⁦1⁩
ברירת מחדל—
שדהresolutionסוגstringדרישהרשותערכים ומגבלות
768, 1K, 1.5K, 2K, 4K
ברירת מחדל—
שדהaspect_ratioסוגstringדרישהרשותערכים ומגבלות
21:9, 2:1, 16:9, 3:2, 7:5, 4:3, 5:4, 1:1, 4:5, 3:4, 5:7, 2:3, 9:16, 1:2, 9:21, auto
ברירת מחדל—
שדהnסוגintegerדרישהרשותערכים ומגבלות
מינימום: ⁦1⁩
מקסימום: ⁦1⁩
ברירת מחדל—
שדהinput_referencesסוגarrayדרישהרשותערכים ומגבלות
מספר פריטים מזערי: ⁦0⁩
מספר פריטים מרבי: ⁦10⁩
ברירת מחדל—
שדהproviderסוגobjectדרישהרשותערכים ומגבלותברירת מחדל—
פרמטרים ומחזור חיים של השיטה
פרמטרמפרט
פרמטרcontent_typeמפרטapplication/json
פרמטרrequiredמפרטmodel, prompt
פרמטרmaterial_typesמפרטtext, image

מחזור חיים: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · ערך task_id שהוחזר בפועל או רשומה בספריית המדיה

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

תעריפים

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

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

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

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

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

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

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

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

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

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

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

Ailoot Ultra · תמונות

set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'black-forest-labs/flux-3-image', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\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 base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n    if not items: raise SystemExit("No completed images; retain the full response")\n    for index, item in enumerate(items):\n        encoded=item.get("b64_json")\n        uri=item.get("url", "")\n        if not encoded and uri.startswith("data:image/"):\n            header, separator, encoded=uri.partition(",")\n            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n        if encoded:\n            raw=base64.b64decode(encoded,validate=True)\n        elif uri:\n            uri=urljoin("https://api.ailoot.ai",uri)\n            parsed=urlsplit(uri)\n            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n                raise SystemExit("Invalid returned image URL")\n            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n            args=["curl","--fail-with-body","--silent","--show-error",uri]\n            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n            temporary=Path(f"image-{index}.bin")\n            subprocess.run(args+["-o",str(temporary)],check=True)\n            raw=temporary.read_bytes()\n            temporary.unlink()\n        else: raise SystemExit("Image has neither bytes nor URL")\n        if not raw: raise SystemExit("Empty image result")\n        ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n        Path(f"image-{index}.{ext}").write_bytes(raw)\n    print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\n

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

Ailoot Ultra · תמונות

הורידו כל תמונה שהוחזרה או שמרו את תוכן ה-Base64 שלה

  • GET /v1/media/tasks/{task_id}
  • GET /v1/media/assets/{asset_id}/content
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
קריאות תוכן נוספות
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\n
שמירת כל התוצאות שהושלמו

שמרו כל תמונה שהושלמה; אחזרו אותה מכל URL שהוחזר או פענחו את תוכן ה-Base64 שלה.

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

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

שמרו את X-Client-Request-ID שהוחזר לצורך התאמת רישומים. קראו רק ערכי task_id/asset_id שהוחזרו בפועל או את ספריית המדיה שבבעלותכם; לעולם אל תבנו URL של משימה ממזהה הפעולה ואל תשלחו שוב בקשת יצירה.

שדות התגובה
שדהסוג
שדהcreatedסוג
שדהdata[].urlסוג
שדהdata[].b64_jsonסוג
שדהusageסוג

כינויים

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

Ailoot Ultra black-forest-labs/flux-3-image

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

/v1/images

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

black-forest-labs/flux-3-image

", "method_identity": { "effective_request_model_id": "black-forest-labs/flux-3-image", "fmt": "images", "http": "POST", "path": "/v1/images/generations", "request_model_id": "black-forest-labs/flux-3-image", "route_label": "Ultra" }, "method_key": "Ultra|images|/v1/images/generations|black-forest-labs%2Fflux-3-image", "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": "Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.", "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "actual returned task_id or media library record", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "שמרו את X-Client-Request-ID שהוחזר לצורך התאמת רישומים. קראו רק ערכי task_id/asset_id שהוחזרו בפועל או את ספריית המדיה שבבעלותכם; לעולם אל תבנו URL של משימה ממזהה הפעולה ואל תשלחו שוב בקשת יצירה." }, "outputs": { "all_results": "שמרו את התשובה המלאה ואת הכותרות, כל פלט שהתקבל בפועל, את המזהים המקוריים שהוחזרו ואת כל שדות השימוש. שחזרו את הפעולה המקורית בלי לשלוח שוב בקשת יצירה.", "family": "image", "fields": [ { "description": null, "name": "created", "type": null }, { "description": null, "name": "data[].url", "type": null }, { "description": null, "name": "data[].b64_json", "type": null }, { "description": null, "name": "usage", "type": null } ] }, "parameters": [ { "enum": [ "black-forest-labs/flux-3-image" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "enum": [ "768", "1K", "1.5K", "2K", "4K" ], "enum_known": true, "name": "resolution", "required": false, "type": "string" }, { "enum": [ "21:9", "2:1", "16:9", "3:2", "7:5", "4:3", "5:4", "1:1", "4:5", "3:4", "5:7", "2:3", "9:16", "1:2", "9:21", "auto" ], "enum_known": true, "name": "aspect_ratio", "required": false, "type": "string" }, { "maximum": 1, "minimum": 1, "name": "n", "required": false, "type": "integer" }, { "items": { "properties": { "image_url": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, "maximum_items": 10, "minimum_items": 0, "name": "input_references", "required": false, "type": "array" }, { "name": "provider", "required": false, "type": "object" } ], "request_schema": { "properties": { "aspect_ratio": { "enum": [ "21:9", "2:1", "16:9", "3:2", "7:5", "4:3", "5:4", "1:1", "4:5", "3:4", "5:7", "2:3", "9:16", "1:2", "9:21", "auto" ], "type": "string" }, "input_references": { "items": { "properties": { "image_url": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, "maxItems": 10, "minItems": 0, "type": "array" }, "model": { "enum": [ "black-forest-labs/flux-3-image" ], "type": "string" }, "n": { "maximum": 1, "minimum": 1, "type": "integer" }, "prompt": { "minLength": 1, "type": "string" }, "provider": { "description": "Exact image provider preferences from the documented image request schema.", "type": "object" }, "resolution": { "enum": [ "768", "1K", "1.5K", "2K", "4K" ], "type": "string" } }, "required": [ "model", "prompt" ], "type": "object" }, "schema_template": { "actual_file_preparation_required": false, "body": { "model": "black-forest-labs/flux-3-image", "prompt": "a red panda astronaut floating in space, studio lighting" }, "content_type": "application/json" } }, "input": { "content_type": "application/json", "material_types": [ "text", "image" ], "required": [ "model", "prompt" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "ערך task_id שהוחזר בפועל או רשומה בספריית המדיה", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Keep the returned X-Client-Request-ID for reconciliation. Read only actual returned task_id/asset_id values or the owned media library; never build a task URL from the operation ID and never resubmit creation." }, "method": { "http": "POST", "path": "/v1/images/generations" }, "output": { "all_results": "Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.", "family": "image", "fields": [ { "description": null, "name": "created", "type": null }, { "description": null, "name": "data[].url", "type": null }, { "description": null, "name": "data[].b64_json", "type": null }, { "description": null, "name": "usage", "type": null } ] } }, "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" } ] }, { "basis": "אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "עלות יצירה משוערת", "units": [ { "amount": "0.082", "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": "0.082", "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}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'black-forest-labs/flux-3-image', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath(\"request.json\").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\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 base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit(\"No completed images; retain the full response\")\n for index, item in enumerate(items):\n encoded=item.get(\"b64_json\")\n uri=item.get(\"url\", \"\")\n if not encoded and uri.startswith(\"data:image/\"):\n header, separator, encoded=uri.partition(\",\")\n if not separator or \";base64\" not in header: raise SystemExit(\"Unsupported image data URI\")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin(\"https://api.ailoot.ai\",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!=\"https\" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit(\"Invalid returned image URL\")\n owned=parsed.netloc==\"api.ailoot.ai\" and parsed.path.startswith(\"/v1/media/assets/\") and parsed.path.endswith(\"/content\")\n args=[\"curl\",\"--fail-with-body\",\"--silent\",\"--show-error\",uri]\n if owned: args += [\"-H\",\"Authorization: Bearer \"+os.environ[\"AILOOT_API_KEY\"]]\n temporary=Path(f\"image-{index}.bin\")\n subprocess.run(args+[\"-o\",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit(\"Image has neither bytes nor URL\")\n if not raw: raise SystemExit(\"Empty image result\")\n ext=\"png\" if raw.startswith(b\"\\x89PNG\") else \"jpg\" if raw.startswith(b\"\\xff\\xd8\") else \"webp\" if raw[:4]==b\"RIFF\" and raw[8:12]==b\"WEBP\" else \"svg\" if raw.lstrip().startswith((b\"; השורה מכילה id, bbox ו־desc. הקואורדינטות הן מספרים שלמים בין 0 ל־1000 בסדר [top, left, bottom, right], הנמדדים מהפינה השמאלית העליונה. למשל, [0, 0, 500, 500] מתאר את הרבע השמאלי העליון בלי קשר לממדי התמונה בפיקסלים. השתמשו ביחס הממדים שעבורו תוכננה הפריסה, משום שרשת הקואורדינטות הזו נמתחת עם המסגרת.\n\nשורת עריכה משתמשת במקום זאת ב־from, ב־src_bbox וב־tgt_bbox לצד המזהה והתיאור. ref_image_0 פירושו התמונה הראשונה שסופקה. תיבות מקור ויעד תואמות מעגנות רכיב; תיבות שונות מזיזות אותו או משנות את גודלו. שורה חדשה ללא מקור יוצרת את התיאור שלה במיקום היעד ומאפשרת הוספות, החלפות או צביעה מחדש. שורת מקור ללא יעד מסירה את הרכיב. ציינו הוספות והסרות הן בהוראה הכתובה והן בשורות, ושמרו שורות עיגון לפרטים שחייבים להישאר במקומם.\n\nתנו לכיתוב תיבה משלו וצטטו את הניסוח המדויק ב־desc. תיבות מנחות מיקום וקנה מידה; הן אינן מסכות חיתוך, ולכן רכיב יכול לחרוג מהמלבן. היצרן מדווח שעצמים חדשים בתיבות של כ־40×25 פיקסלים לעיתים קרובות לא הופיעו בדוגמאות שלו. הקצו מספיק מרחב גלוי ובדקו את הגבולות שנערכו. פיקסלים מחוץ ליעד נשארים בדרך כלל יציבים, אך צללים, השתקפויות ותאורה סמוכה עדיין יכולים להשתנות.\n\n### עיגון במידע, דרגות פלט ורשומות שימושיות\n\nהפרופיל המתועד מפעיל עיגון במידע כברירת מחדל, ומאפשר לחיפוש ברשת ובתמונות לספק מידע ליצירה. אפשר להשביתו לבריף שצריך להשתמש רק בתיאור ובייחוסים שסופקו. לנושא מהעולם האמיתי, זהו בבירור את המיקום, האירוע או העצם והפרידו בין תוכן עובדתי לטיפול אמנותי. גם תמונות המבוססות על חיפוש דורשות השוואה לחומר סמכותי כאשר תווית, עצם או אירוע מתואר חייבים להיות מדויקים.\n\nחמש דרגות הרזולוציה הן 768sq, 1k, 1.5k, 2k ו־4k, עם 1k כברירת מחדל. הן מייצגות דרגות של שטח פיקסלים שווה, ולכן הרוחב והגובה המדויקים תלויים ביחס שנבחר. חמישה עשר יחסים קבועים נעים מ־21:9 דרך פורמטים ריבועיים ולאורך ועד 9:21. הפרופיל של המודל הזה שולט בגודל באמצעות יחס ורזולוציה; הוא אינו חושף את שדות seed, width או height המשמשים בפרופילי הבקשה של FLUX.2. בורר הגרסה המתועד שלו מציין כיום מהדורה מתעדכנת, ולא קובע התאמה למשקלי ספק מתוארכים.\n\nתהליך העבודה של היצרן מחזיר תמונה לאחר עיבוד אסינכרוני, יחד עם ההנחיה המורחבת. קישור הורדת התמונה החתום שלו תקף לשעה אחת. שמרו את התמונה עצמה, את ההנחיה הסופית ואת הייחוסים במקום להסתמך על קישור זמני. לנכס שנבדק, השוו את הטקסט שהתבקש, מיקום העצמים, זהות הייחוסים והאזור ששונה בגודל התצוגה המיועד. יצירה שהושלמה היא נקודת הפתיחה לבדיקת הדרישות החזותיות האלה.", "alias_of": null, "aliases": [], "author": "Black Forest Labs", "capabilities": { "context_length": 46864, "manufacturer_input": [ "text", "image" ], "manufacturer_output": [ "image" ] }, "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "0.082", "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": "0.082", "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, "formats": [ "images" ], "id": "black-forest-labs/flux-3-image", "input": [ "text", "image" ], "kind": "image", "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": "Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.", "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "actual returned task_id or media library record", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "שמרו את X-Client-Request-ID שהוחזר לצורך התאמת רישומים. קראו רק ערכי task_id/asset_id שהוחזרו בפועל או את ספריית המדיה שבבעלותכם; לעולם אל תבנו URL של משימה ממזהה הפעולה ואל תשלחו שוב בקשת יצירה." }, "outputs": { "all_results": "שמרו את התשובה המלאה ואת הכותרות, כל פלט שהתקבל בפועל, את המזהים המקוריים שהוחזרו ואת כל שדות השימוש. שחזרו את הפעולה המקורית בלי לשלוח שוב בקשת יצירה.", "family": "image", "fields": [ { "description": null, "name": "created", "type": null }, { "description": null, "name": "data[].url", "type": null }, { "description": null, "name": "data[].b64_json", "type": null }, { "description": null, "name": "usage", "type": null } ] }, "parameters": [ { "enum": [ "black-forest-labs/flux-3-image" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "enum": [ "768", "1K", "1.5K", "2K", "4K" ], "enum_known": true, "name": "resolution", "required": false, "type": "string" }, { "enum": [ "21:9", "2:1", "16:9", "3:2", "7:5", "4:3", "5:4", "1:1", "4:5", "3:4", "5:7", "2:3", "9:16", "1:2", "9:21", "auto" ], "enum_known": true, "name": "aspect_ratio", "required": false, "type": "string" }, { "maximum": 1, "minimum": 1, "name": "n", "required": false, "type": "integer" }, { "items": { "properties": { "image_url": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, "maximum_items": 10, "minimum_items": 0, "name": "input_references", "required": false, "type": "array" }, { "name": "provider", "required": false, "type": "object" } ], "request_schema": { "properties": { "aspect_ratio": { "enum": [ "21:9", "2:1", "16:9", "3:2", "7:5", "4:3", "5:4", "1:1", "4:5", "3:4", "5:7", "2:3", "9:16", "1:2", "9:21", "auto" ], "type": "string" }, "input_references": { "items": { "properties": { "image_url": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, "maxItems": 10, "minItems": 0, "type": "array" }, "model": { "enum": [ "black-forest-labs/flux-3-image" ], "type": "string" }, "n": { "maximum": 1, "minimum": 1, "type": "integer" }, "prompt": { "minLength": 1, "type": "string" }, "provider": { "description": "Exact image provider preferences from the documented image request schema.", "type": "object" }, "resolution": { "enum": [ "768", "1K", "1.5K", "2K", "4K" ], "type": "string" } }, "required": [ "model", "prompt" ], "type": "object" }, "schema_template": { "actual_file_preparation_required": false, "body": { "model": "black-forest-labs/flux-3-image", "prompt": "a red panda astronaut floating in space, studio lighting" }, "content_type": "application/json" } }, "input": { "content_type": "application/json", "material_types": [ "text", "image" ], "required": [ "model", "prompt" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "ערך task_id שהוחזר בפועל או רשומה בספריית המדיה", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Keep the returned X-Client-Request-ID for reconciliation. Read only actual returned task_id/asset_id values or the owned media library; never build a task URL from the operation ID and never resubmit creation." }, "method": { "http": "POST", "path": "/v1/images/generations" }, "output": { "all_results": "Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.", "family": "image", "fields": [ { "description": null, "name": "created", "type": null }, { "description": null, "name": "data[].url", "type": null }, { "description": null, "name": "data[].b64_json", "type": null }, { "description": null, "name": "usage", "type": null } ] } }, "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" } ] }, { "basis": "אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "עלות יצירה משוערת", "units": [ { "amount": "0.082", "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": "0.082", "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}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'black-forest-labs/flux-3-image', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath(\"request.json\").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\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 base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit(\"No completed images; retain the full response\")\n for index, item in enumerate(items):\n encoded=item.get(\"b64_json\")\n uri=item.get(\"url\", \"\")\n if not encoded and uri.startswith(\"data:image/\"):\n header, separator, encoded=uri.partition(\",\")\n if not separator or \";base64\" not in header: raise SystemExit(\"Unsupported image data URI\")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin(\"https://api.ailoot.ai\",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!=\"https\" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit(\"Invalid returned image URL\")\n owned=parsed.netloc==\"api.ailoot.ai\" and parsed.path.startswith(\"/v1/media/assets/\") and parsed.path.endswith(\"/content\")\n args=[\"curl\",\"--fail-with-body\",\"--silent\",\"--show-error\",uri]\n if owned: args += [\"-H\",\"Authorization: Bearer \"+os.environ[\"AILOOT_API_KEY\"]]\n temporary=Path(f\"image-{index}.bin\")\n subprocess.run(args+[\"-o\",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit(\"Image has neither bytes nor URL\")\n if not raw: raise SystemExit(\"Empty image result\")\n ext=\"png\" if raw.startswith(b\"\\x89PNG\") else \"jpg\" if raw.startswith(b\"\\xff\\xd8\") else \"webp\" if raw[:4]==b\"RIFF\" and raw[8:12]==b\"WEBP\" else \"svg\" if raw.lstrip().startswith((b\"