Black Forest Labs: FLUX.2 Max

FLUX.2 [max] הוא מודל התמונות של Black Forest Labs לנכסים סופיים תובעניים ולעריכות עקביות. הפרופיל המתועד שלו משלב ייחוסים חזותיים, שליטה מפורטת בסצנה ועיגון במידע מהרשת לנושאים עדכניים, עם פלט של עד 4 מגה־פיקסלים.

Ailoot Ultra · תמונות POST /v1/images/generations black-forest-labs/flux.2-max

על המודל

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

FLUX.2 [max] הוא הדגם האיכותי ביותר של Black Forest Labs במשפחת FLUX.2 ליצירת תמונות ולעריכתן. היצרן מייעד אותו לנכסים סופיים תובעניים, להיצמדות גבוהה לבריף מורכב ולעקביות בין עריכות. הוא יוצר תמונה מתיאור כתוב או משתמש בתמונות שסופקו כייחוסים חזותיים. יכולת המשפחה שמייחדת אותו היא חיפוש לצורך עיגון במידע: בקשה יכולה להסתמך על מידע עדכני במקום רק על הסצנה המתוארת בהנחיה.

מידע מהעולם האמיתי והבריף החזותי

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

יכולת החיפוש הזו שייכת ל־[max] בהשוואת FLUX.2 שפורסמה. לדגמים האחרים בעלי השמות המוגדרים יש תפקידים משלהם: [pro] להפקה, [flex] לדגימה מתכווננת ולטיפוגרפיה, ו־[klein] ליצירה אינטראקטיבית קומפקטית. שמרו את שם המודל שנבחר עם התוצאה, כדי שתיקון מאוחר לא יחליף בשקט את הפרופיל בעל יכולת העיגון במהדורה אחרת.

ייחוסים לעריכות תובעניות

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

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

טקסט, צבעים ופרשנות ההנחיה

מדריך FLUX.2 ממליץ על מבנה של נושא–פעולה–סגנון–הקשר, עם הרכיבים החשובים תחילה. הוא מציע 10–30 מילים לקונספטים מהירים, 30–80 לפרויקטים רגילים ותיאורים ארוכים יותר לסצנה מורכבת. אלה המלצות כתיבה, ולא מגבלות הקשר קשיחות. שפה טבעית ותיאורי סצנה במבנה JSON הן שתי דרכים מתועדות לארגון נושאים, מיקום, תאורה וסגנון. הנחיה מובנית היא בריף לתמונה, ולא הבטחה לתגובה טקסטואלית מובנית.

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

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

הפלט ונכס סופי שימושי

מדריך המשפחה מתעד תמונות של עד 4 מגה־פיקסלים, עם ממדים מפורשים של לפחות 64×64 ובכפולות של 16. ההמלצה שלו לשימוש רגיל היא עד 2 מגה־פיקסלים. הפרופיל המדויק של [max] מציין JPEG, PNG ו־WebP, עם JPEG כברירת מחדל וערך seed אקראי אופציונלי. בחרו את מבנה הפלט לפי המיקום המיועד לפני סידור הקומפוזיציה. יצירת התמונות של המודל נפרדת משינוי גודל של נכס שכבר הושלם.

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

Ailoot Ultra · תמונות POST /v1/images/generations black-forest-labs/flux.2-max

black-forest-labs/flux.2-max

Black Forest Labs /black-forest-labs/flux.2-max

התחלה

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

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

Ailoot Ultra · תמונות POST /v1/images/generations

סוגי קלט: text, image
סוגי פלט: image

שדה	סוג	דרישה	ערכים ומגבלות	ברירת מחדל
שדה`model`	סוג`string`	דרישהחובה	ערכים ומגבלות black-forest-labs/flux.2-max	ברירת מחדל—
שדה`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}

תעריפים

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

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

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

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

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

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

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

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

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

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

Ailoot Ultra · תמונות

curl

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'black-forest-labs/flux.2-max', 'prompt': 'a red panda astronaut floating in space, studio lighting'}

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        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"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT

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

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
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.

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

שמרו כל תמונה שהושלמה; אחזרו אותה מכל 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-max

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

/v1/images

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

black-forest-labs/flux.2-max

FAQ · Black Forest Labs: FLUX.2 Max

אילו קלטים ותוצאות זמינים?: POST /v1/images/generations · black-forest-labs/flux.2-max: text, image → image
באילו שדות הבקשה משתמשת?: POST /v1/images/generations · black-forest-labs/flux.2-max: model, prompt, aspect_ratio, output_format, n, input_references, provider
אילו מגבלות חלות?: POST /v1/images/generations · black-forest-labs/flux.2-max: n.minimum: 1; n.maximum: 1

Black Forest Labs: FLUX.2 Max