Black Forest Labs: FLUX.2 Flex

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

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

על המודל

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

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

כיתוב ופרטים עדינים

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

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

צעדים והכוונה משרתים מטרות שונות

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

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

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

תיקונים המונחים באמצעות ייחוסים

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

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

גודל, צבע והתמונה שהוחזרה

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

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

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

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

black-forest-labs/flux.2-flex

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

התחלה

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

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

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

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

שדה	סוג	דרישה	ערכים ומגבלות	ברירת מחדל
שדה`model`	סוג`string`	דרישהחובה	ערכים ומגבלות black-forest-labs/flux.2-flex	ברירת מחדל—
שדה`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.12 לכל מגה-פיקסל של תמונת קלט
תצורהמגה-פיקסל של תמונת פלט	טבלת תעריפים—	כמות חזויה—	יחידת חיובלכל מגה-פיקסל של תמונת פלט	חיוב פלט · מגה-פיקסל של תמונת פלט · אומדן להשוואה בלבד $0.12 לכל מגה-פיקסל של תמונת פלט
תצורהעלות יצירה משוערת	טבלת תעריפים—	כמות חזויהאומדן ליצירה אחת	יחידת חיוב—	חיוב פלט · עלות יצירה משוערת · אומדן להשוואה בלבד $0.12 אומדן לפני היצירה אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה.

לפני הבקשה 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-flex', '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-flex

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

/v1/images

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

black-forest-labs/flux.2-flex

FAQ · Black Forest Labs: FLUX.2 Flex

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

Black Forest Labs: FLUX.2 Flex