FLUX.2 [pro] הוא מודל ליצירת תמונות ולעריכתן של Black Forest Labs, הממוקד בצורכי הפקה. היצרן מציג אותו כברירת המחדל לרוב המשימות החזותיות של FLUX.2: יצירת תמונה חדשה מטקסט או תיקון סצנה באמצעות ייחוסים חזותיים. יכולות המשפחה כוללות חומרים ותאורה פוטוריאליסטיים, טקסט קריא, הוראות צבע מדויקות ונושאים עקביים בין עריכות קשורות. התוצר המוחזר הוא תמונה לשימוש בסצנת מוצר, בקומפוזיציה מערכתית, בקונספט עיצובי או בתקשורת חזותית.
התחילו בנושא, במה שהוא עושה או באופן שבו הוא מסודר, בסגנון ובסביבה או בתאורה. מדריך ההנחיות של היצרן מעניק משקל רב יותר למילים המוקדמות וממליץ להציב את הנושא והפעולה החיוניים לפני פרטים דקורטיביים. הוא מציע 10–30 מילים לקונספטים מהירים ו־30–80 לפרויקטים רגילים, עם תיאורים ארוכים יותר לסצנות מורכבות. הטווחים האלה הם הנחיות כתיבה, ולא מגבלת הקשר של טקסט.
בריף קטלוג מקורי עשוי להציג מנורת פלדה מוברשת על משטח שולחן באפור חם, במבט של שלושה רבעים החושף את המתג ואת האהיל. הגדירו את המשטח, התאורה ונקודת המבט שהופכים את המוצר למזוהה. לאינפוגרפיקה או לתמונת שיווק, קבעו קודם את הניסוח הגלוי ואת ההיררכיה; צטטו את הכותרת המדויקת, ציינו את מיקומה והגדירו את הסגנון ואת גודל האותיות. בדקו תוויות, כמויות ופרטי מוצר בגודל התצוגה הסופי.
מדריך המשפחה מתעד הן הנחיות בשפה טבעית והן הנחיות במבנה JSON. בריף סצנה מובנה יכול לשמור נושא, רקע, תאורה וקומפוזיציה בשדות נפרדים, כך שאפשר יהיה לתקן דרישה אחת בבירור. הוא תומך גם בתיאורי צבע הקסדצימליים: שייכו את הקוד לעצם או לטקסט המסוימים שיש לצבוע. תארו את המראה הרצוי באופן חיובי, משום שתהליך ההנחיות המתועד של FLUX.2 אינו מספק הנחיות שליליות.
פרופיל הבקשה המדויק של [pro] מציע שמונה מיקומים לתמונות ייחוס; הממשק האינטראקטיבי של היצרן תומך בנפרד בעשר. הקצו לכל תמונה תפקיד, כגון מראה הנושא, לבוש, עיצוב מוצר, חדר או סגנון. לסצנה קיימת, ציינו את הרכיב שיש לשנות ואת הקומפוזיציה, הסביבה והפרטים החזותיים שצריכים להישמר. הדוגמאות שפורסמו כוללות שילובי רהיטים, שינויי רקע או מזג אוויר, החלפת עצמים ותיקוני טקסט.
קיבולת הייחוסים תלויה גם בגודל הפלט. מדריך [pro] של היצרן מגדיר תקציב כולל של 9 מגה־פיקסלים לקלט ולפלט יחד. הדוגמאות שלו מאפשרות שמונה ייחוסים בפלט של 1 מגה־פיקסל ושבעה בפלט של 2 מגה־פיקסלים, תוך הפחתת קיבולת הייחוסים כשהתוצאה המבוקשת גדלה. תכננו יחד את מערך המקורות ואת הפלט, במקום להתייחס למספר המיקומים המרבי כזמין לכל גודל פלט. השתמשו בייחוסים שמבססים מידע נחוץ וציינו את תרומתם הרצויה.
בשילוב מוצר, התמונה הראשונה יכולה לספק את המוצר והשנייה את החדר, בעוד שלישית קובעת את גימור החומר. הסבירו כיצד עליהן להפוך לסצנה מגובשת אחת. אם התוצאה משנה צורה, סימון או זהות שהיו אמורים להישמר, התמקדו בבעיה הזו בהמשך במקום להחליף את הבריף כולו. התוצאה המעשית היא התמונה המתוקנת, שאת נאמנותה לייחוסים ואת השינוי המסוים בה משווים לקלטים שלה.
המפרט המדויק של [pro] מפעיל הרחבת הנחיה כברירת מחדל. הבקרה disable_pup שלו עוצרת את ההרחבה כאשר הוראה שנכתבה בקפידה צריכה לשמש כפי שסופקה. שמרו על ההגדרה שנבחרה בהשוואת גרסאות, משום שאותו קונספט קצר ותיאור מורחב הם קלטי יצירה שונים. זו בקרה של פרופיל היצרן, ולא הבטחה שכל פרט שהתבקש מופיע נכון.
התיעוד מבחין בין נקודת הקצה הרגילה [pro] כצילום מצב קבוע לבין [pro] Preview, שבה נוספים שיפורי מודל בהמשך. מבני הבקשה והתגובה שלהן זהים, אך המשקלים שבבסיסן שונים. שמרו את הפרופיל המדויק שנבחר עם התמונה והייחוסים. התווית הנפרדת Preview אינה צריכה להחליף בשקט בחירה רגילה של [pro] כאשר תיקון תלוי באותה בחירת מודל מתועדת.
מדריך המשפחה מתעד פלט של עד 4 מגה־פיקסלים, עם ממדים מפורשים של לפחות 64×64 ובכפולות של 16. הוא ממליץ על עד 2 מגה־פיקסלים לרוב השימושים. הרוחב והגובה קובעים את המסגור הרצוי; תמונת מוצר ריבועית, פריסה לאורך וסצנה מערכתית רחבה מחלקות את השטח אחרת. הבקשה המדויקת מציינת פלט JPEG, PNG ו־WebP, עם JPEG כברירת מחדל וערך seed אופציונלי.
לפרופיל [max] יש תכונת חיפוש נפרדת לעיגון במידע, ואילו [flex] חושף צעדי דגימה והכוונה ול־[klein] יש פרופיל קטן יותר של ארבעה ייחוסים. בחרו את המהדורה לפי העבודה הנדרשת במקום לייבא את הבקרות האלה ל־[pro]. לנכס הנבחר, שמרו את התמונה עצמה, ההנחיה הסופית, הייחוסים, הממדים ותווית המודל. קישורי התוצאה החתומים של FLUX.2 אצל היצרן פגים אחרי עשר דקות, לכן אחזרו את התמונה במקום להסתמך על מיקומה הזמני. בדקו זהות נושא, צבעים, טקסט, קומפוזיציה ופרטים שנערכו לפני שילוב התוצאה בחומר המיועד ללקוחות.
", "aboutText": "FLUX.2 [pro] הוא מודל ליצירת תמונות ולעריכתן של Black Forest Labs, הממוקד בצורכי הפקה. היצרן מציג אותו כברירת המחדל לרוב המשימות החזותיות של FLUX.2: יצירת תמונה חדשה מטקסט או תיקון סצנה באמצעות ייחוסים חזותיים. יכולות המשפחה כוללות חומרים ותאורה פוטוריאליסטיים, טקסט קריא, הוראות צבע מדויקות ונושאים עקביים בין עריכות קשורות. התוצר המוחזר הוא תמונה לשימוש בסצנת מוצר, בקומפוזיציה מערכתית, בקונספט עיצובי או בתקשורת חזותית.\n\n### הכינו בריף להפקה\n\nהתחילו בנושא, במה שהוא עושה או באופן שבו הוא מסודר, בסגנון ובסביבה או בתאורה. מדריך ההנחיות של היצרן מעניק משקל רב יותר למילים המוקדמות וממליץ להציב את הנושא והפעולה החיוניים לפני פרטים דקורטיביים. הוא מציע 10–30 מילים לקונספטים מהירים ו־30–80 לפרויקטים רגילים, עם תיאורים ארוכים יותר לסצנות מורכבות. הטווחים האלה הם הנחיות כתיבה, ולא מגבלת הקשר של טקסט.\n\nבריף קטלוג מקורי עשוי להציג מנורת פלדה מוברשת על משטח שולחן באפור חם, במבט של שלושה רבעים החושף את המתג ואת האהיל. הגדירו את המשטח, התאורה ונקודת המבט שהופכים את המוצר למזוהה. לאינפוגרפיקה או לתמונת שיווק, קבעו קודם את הניסוח הגלוי ואת ההיררכיה; צטטו את הכותרת המדויקת, ציינו את מיקומה והגדירו את הסגנון ואת גודל האותיות. בדקו תוויות, כמויות ופרטי מוצר בגודל התצוגה הסופי.\n\nמדריך המשפחה מתעד הן הנחיות בשפה טבעית והן הנחיות במבנה JSON. בריף סצנה מובנה יכול לשמור נושא, רקע, תאורה וקומפוזיציה בשדות נפרדים, כך שאפשר יהיה לתקן דרישה אחת בבירור. הוא תומך גם בתיאורי צבע הקסדצימליים: שייכו את הקוד לעצם או לטקסט המסוימים שיש לצבוע. תארו את המראה הרצוי באופן חיובי, משום שתהליך ההנחיות המתועד של FLUX.2 אינו מספק הנחיות שליליות.\n\n### ערכו עם ייחוסים ותקציב פיקסלים משותף\n\nפרופיל הבקשה המדויק של [pro] מציע שמונה מיקומים לתמונות ייחוס; הממשק האינטראקטיבי של היצרן תומך בנפרד בעשר. הקצו לכל תמונה תפקיד, כגון מראה הנושא, לבוש, עיצוב מוצר, חדר או סגנון. לסצנה קיימת, ציינו את הרכיב שיש לשנות ואת הקומפוזיציה, הסביבה והפרטים החזותיים שצריכים להישמר. הדוגמאות שפורסמו כוללות שילובי רהיטים, שינויי רקע או מזג אוויר, החלפת עצמים ותיקוני טקסט.\n\nקיבולת הייחוסים תלויה גם בגודל הפלט. מדריך [pro] של היצרן מגדיר תקציב כולל של 9 מגה־פיקסלים לקלט ולפלט יחד. הדוגמאות שלו מאפשרות שמונה ייחוסים בפלט של 1 מגה־פיקסל ושבעה בפלט של 2 מגה־פיקסלים, תוך הפחתת קיבולת הייחוסים כשהתוצאה המבוקשת גדלה. תכננו יחד את מערך המקורות ואת הפלט, במקום להתייחס למספר המיקומים המרבי כזמין לכל גודל פלט. השתמשו בייחוסים שמבססים מידע נחוץ וציינו את תרומתם הרצויה.\n\nבשילוב מוצר, התמונה הראשונה יכולה לספק את המוצר והשנייה את החדר, בעוד שלישית קובעת את גימור החומר. הסבירו כיצד עליהן להפוך לסצנה מגובשת אחת. אם התוצאה משנה צורה, סימון או זהות שהיו אמורים להישמר, התמקדו בבעיה הזו בהמשך במקום להחליף את הבריף כולו. התוצאה המעשית היא התמונה המתוקנת, שאת נאמנותה לייחוסים ואת השינוי המסוים בה משווים לקלטים שלה.\n\n### הרחבת הנחיה ופרופילים קבועים לעומת Preview\n\nהמפרט המדויק של [pro] מפעיל הרחבת הנחיה כברירת מחדל. הבקרה disable_pup שלו עוצרת את ההרחבה כאשר הוראה שנכתבה בקפידה צריכה לשמש כפי שסופקה. שמרו על ההגדרה שנבחרה בהשוואת גרסאות, משום שאותו קונספט קצר ותיאור מורחב הם קלטי יצירה שונים. זו בקרה של פרופיל היצרן, ולא הבטחה שכל פרט שהתבקש מופיע נכון.\n\nהתיעוד מבחין בין נקודת הקצה הרגילה [pro] כצילום מצב קבוע לבין [pro] Preview, שבה נוספים שיפורי מודל בהמשך. מבני הבקשה והתגובה שלהן זהים, אך המשקלים שבבסיסן שונים. שמרו את הפרופיל המדויק שנבחר עם התמונה והייחוסים. התווית הנפרדת Preview אינה צריכה להחליף בשקט בחירה רגילה של [pro] כאשר תיקון תלוי באותה בחירת מודל מתועדת.\n\n### ממדים, פורמטים והנכס שנבחר\n\nמדריך המשפחה מתעד פלט של עד 4 מגה־פיקסלים, עם ממדים מפורשים של לפחות 64×64 ובכפולות של 16. הוא ממליץ על עד 2 מגה־פיקסלים לרוב השימושים. הרוחב והגובה קובעים את המסגור הרצוי; תמונת מוצר ריבועית, פריסה לאורך וסצנה מערכתית רחבה מחלקות את השטח אחרת. הבקשה המדויקת מציינת פלט JPEG, PNG ו־WebP, עם JPEG כברירת מחדל וערך seed אופציונלי.\n\nלפרופיל [max] יש תכונת חיפוש נפרדת לעיגון במידע, ואילו [flex] חושף צעדי דגימה והכוונה ול־[klein] יש פרופיל קטן יותר של ארבעה ייחוסים. בחרו את המהדורה לפי העבודה הנדרשת במקום לייבא את הבקרות האלה ל־[pro]. לנכס הנבחר, שמרו את התמונה עצמה, ההנחיה הסופית, הייחוסים, הממדים ותווית המודל. קישורי התוצאה החתומים של FLUX.2 אצל היצרן פגים אחרי עשר דקות, לכן אחזרו את התמונה במקום להסתמך על מיקומה הזמני. בדקו זהות נושא, צבעים, טקסט, קומפוזיציה ופרטים שנערכו לפני שילוב התוצאה בחומר המיועד ללקוחות.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "0976cb8fb631aced1036f2c9bd6adedb9e21c7b961a1624a1c8d33312bb54e6a", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "he", "methods": [ { "html": "black-forest-labs/flux.2-proFLUX.2 [pro] הוא מודל התמונות של Black Forest Labs לעבודה בהפקה, ליצירה מטקסט ולעריכה בהנחיית ייחוסים. הפרופיל המתועד שלו משלב פרטים פוטוריאליסטיים ושליטה בטקסט ובצבע, עם תקציב פיקסלים משותף לייחוסים ולפלט ותמונות בגודל של עד 4 מגה־פיקסלים.
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
FLUX.2 [pro] הוא מודל ליצירת תמונות ולעריכתן של Black Forest Labs, הממוקד בצורכי הפקה. היצרן מציג אותו כברירת המחדל לרוב המשימות החזותיות של FLUX.2: יצירת תמונה חדשה מטקסט או תיקון סצנה באמצעות ייחוסים חזותיים. יכולות המשפחה כוללות חומרים ותאורה פוטוריאליסטיים, טקסט קריא, הוראות צבע מדויקות ונושאים עקביים בין עריכות קשורות. התוצר המוחזר הוא תמונה לשימוש בסצנת מוצר, בקומפוזיציה מערכתית, בקונספט עיצובי או בתקשורת חזותית.
התחילו בנושא, במה שהוא עושה או באופן שבו הוא מסודר, בסגנון ובסביבה או בתאורה. מדריך ההנחיות של היצרן מעניק משקל רב יותר למילים המוקדמות וממליץ להציב את הנושא והפעולה החיוניים לפני פרטים דקורטיביים. הוא מציע 10–30 מילים לקונספטים מהירים ו־30–80 לפרויקטים רגילים, עם תיאורים ארוכים יותר לסצנות מורכבות. הטווחים האלה הם הנחיות כתיבה, ולא מגבלת הקשר של טקסט.
בריף קטלוג מקורי עשוי להציג מנורת פלדה מוברשת על משטח שולחן באפור חם, במבט של שלושה רבעים החושף את המתג ואת האהיל. הגדירו את המשטח, התאורה ונקודת המבט שהופכים את המוצר למזוהה. לאינפוגרפיקה או לתמונת שיווק, קבעו קודם את הניסוח הגלוי ואת ההיררכיה; צטטו את הכותרת המדויקת, ציינו את מיקומה והגדירו את הסגנון ואת גודל האותיות. בדקו תוויות, כמויות ופרטי מוצר בגודל התצוגה הסופי.
מדריך המשפחה מתעד הן הנחיות בשפה טבעית והן הנחיות במבנה JSON. בריף סצנה מובנה יכול לשמור נושא, רקע, תאורה וקומפוזיציה בשדות נפרדים, כך שאפשר יהיה לתקן דרישה אחת בבירור. הוא תומך גם בתיאורי צבע הקסדצימליים: שייכו את הקוד לעצם או לטקסט המסוימים שיש לצבוע. תארו את המראה הרצוי באופן חיובי, משום שתהליך ההנחיות המתועד של FLUX.2 אינו מספק הנחיות שליליות.
פרופיל הבקשה המדויק של [pro] מציע שמונה מיקומים לתמונות ייחוס; הממשק האינטראקטיבי של היצרן תומך בנפרד בעשר. הקצו לכל תמונה תפקיד, כגון מראה הנושא, לבוש, עיצוב מוצר, חדר או סגנון. לסצנה קיימת, ציינו את הרכיב שיש לשנות ואת הקומפוזיציה, הסביבה והפרטים החזותיים שצריכים להישמר. הדוגמאות שפורסמו כוללות שילובי רהיטים, שינויי רקע או מזג אוויר, החלפת עצמים ותיקוני טקסט.
קיבולת הייחוסים תלויה גם בגודל הפלט. מדריך [pro] של היצרן מגדיר תקציב כולל של 9 מגה־פיקסלים לקלט ולפלט יחד. הדוגמאות שלו מאפשרות שמונה ייחוסים בפלט של 1 מגה־פיקסל ושבעה בפלט של 2 מגה־פיקסלים, תוך הפחתת קיבולת הייחוסים כשהתוצאה המבוקשת גדלה. תכננו יחד את מערך המקורות ואת הפלט, במקום להתייחס למספר המיקומים המרבי כזמין לכל גודל פלט. השתמשו בייחוסים שמבססים מידע נחוץ וציינו את תרומתם הרצויה.
בשילוב מוצר, התמונה הראשונה יכולה לספק את המוצר והשנייה את החדר, בעוד שלישית קובעת את גימור החומר. הסבירו כיצד עליהן להפוך לסצנה מגובשת אחת. אם התוצאה משנה צורה, סימון או זהות שהיו אמורים להישמר, התמקדו בבעיה הזו בהמשך במקום להחליף את הבריף כולו. התוצאה המעשית היא התמונה המתוקנת, שאת נאמנותה לייחוסים ואת השינוי המסוים בה משווים לקלטים שלה.
המפרט המדויק של [pro] מפעיל הרחבת הנחיה כברירת מחדל. הבקרה disable_pup שלו עוצרת את ההרחבה כאשר הוראה שנכתבה בקפידה צריכה לשמש כפי שסופקה. שמרו על ההגדרה שנבחרה בהשוואת גרסאות, משום שאותו קונספט קצר ותיאור מורחב הם קלטי יצירה שונים. זו בקרה של פרופיל היצרן, ולא הבטחה שכל פרט שהתבקש מופיע נכון.
התיעוד מבחין בין נקודת הקצה הרגילה [pro] כצילום מצב קבוע לבין [pro] Preview, שבה נוספים שיפורי מודל בהמשך. מבני הבקשה והתגובה שלהן זהים, אך המשקלים שבבסיסן שונים. שמרו את הפרופיל המדויק שנבחר עם התמונה והייחוסים. התווית הנפרדת Preview אינה צריכה להחליף בשקט בחירה רגילה של [pro] כאשר תיקון תלוי באותה בחירת מודל מתועדת.
מדריך המשפחה מתעד פלט של עד 4 מגה־פיקסלים, עם ממדים מפורשים של לפחות 64×64 ובכפולות של 16. הוא ממליץ על עד 2 מגה־פיקסלים לרוב השימושים. הרוחב והגובה קובעים את המסגור הרצוי; תמונת מוצר ריבועית, פריסה לאורך וסצנה מערכתית רחבה מחלקות את השטח אחרת. הבקשה המדויקת מציינת פלט JPEG, PNG ו־WebP, עם JPEG כברירת מחדל וערך seed אופציונלי.
לפרופיל [max] יש תכונת חיפוש נפרדת לעיגון במידע, ואילו [flex] חושף צעדי דגימה והכוונה ול־[klein] יש פרופיל קטן יותר של ארבעה ייחוסים. בחרו את המהדורה לפי העבודה הנדרשת במקום לייבא את הבקרות האלה ל־[pro]. לנכס הנבחר, שמרו את התמונה עצמה, ההנחיה הסופית, הייחוסים, הממדים ותווית המודל. קישורי התוצאה החתומים של FLUX.2 אצל היצרן פגים אחרי עשר דקות, לכן אחזרו את התמונה במקום להסתמך על מיקומה הזמני. בדקו זהות נושא, צבעים, טקסט, קומפוזיציה ופרטים שנערכו לפני שילוב התוצאה בחומר המיועד ללקוחות.
POST /v1/images/generationstext, imageimage| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות black-forest-labs/flux.2-pro | ברירת מחדל— |
שדהprompt | סוגstring | דרישהחובה | ערכים ומגבלות אורך מזערי: 1 | ברירת מחדל— |
שדהaspect_ratio | סוגstring | דרישהרשות | ערכים ומגבלות 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto | ברירת מחדל— |
שדהoutput_format | סוגstring | דרישהרשות | ערכים ומגבלות png, jpeg | ברירת מחדל— |
שדהn | סוגinteger | דרישהרשות | ערכים ומגבלות מינימום: 1 מקסימום: 1 | ברירת מחדל— |
שדהinput_references | סוגarray | דרישהרשות | ערכים ומגבלות מספר פריטים מזערי: 0 מספר פריטים מרבי: 8 | ברירת מחדל— |
שדה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}
התעריפים המוצגים מספקים אומדן לעלות לפני היצירה. החיוב הסופי מחושב לפי העלות שנרשמה עבור היצירה המקורית. משך הפלט שנמדד והכמויות החזויות אינם הכמות הסופית לחיוב.
מידע תעריפים אינו מוסיף אפשרויות לבקשה. הפרמטרים הנתמכים מפורטים בשיטה שנבחרה.
התאימו כל חיוב לתנאים המוצגים. השתמשו בתעריף אחד לכל קבוצה של תצורות חלופיות.
| תצורה | טבלת תעריפים | כמות חזויה | יחידת חיוב | חיוב |
|---|---|---|---|---|
| תצורהתעריפי בסיס לטוקנים | טבלת תעריפיםתעריף בסיס | כמות חזויה— | יחידת חיוב— | חיוב קלט · טוקני קלט · אומדן להשוואה בלבד — / 1K טוקנים פלט · טוקני פלט · אומדן להשוואה בלבד — / 1K טוקנים קלט · קריאה מהמטמון · אומדן להשוואה בלבד — / 1K טוקנים קלט · כתיבה למטמון · אומדן להשוואה בלבד — / 1K טוקנים קלט · כתיבה למטמון, 1 שעה · אומדן להשוואה בלבד — / 1K טוקנים |
| תצורהמגה-פיקסל של תמונת פלט | טבלת תעריפים— | כמות חזויה— | יחידת חיובלכל מגה-פיקסל של תמונת פלט | חיוב פלט · מגה-פיקסל של תמונת פלט · אומדן להשוואה בלבד $0.06 לכל מגה-פיקסל של תמונת פלט |
| תצורהעלות יצירה משוערת | טבלת תעריפים— | כמות חזויהאומדן ליצירה אחת | יחידת חיוב— | חיוב פלט · עלות יצירה משוערת · אומדן להשוואה בלבד $0.06 אומדן לפני היצירה אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה. |
לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →
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.2-pro', '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הורידו כל תמונה שהוחזרה או שמרו את תוכן ה-Base64 שלה
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /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.2-pro
/v1/images