Black Forest Labs: FLUX.2 Klein 4B

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

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

על המודל

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

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

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

עריכה עם מערך ייחוסים קטן

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

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

הגדרות פלט וגבולות המהדורות

הפרופיל המדויק של 4B אצל היצרן מציין פלט JPEG, PNG ו־WebP, עם JPEG כברירת מחדל. ערכי רוחב וגובה מפורשים מתועדים עם מינימום של 64 פיקסלים לכל אחד; דוגמת הייחוס בכרטיס המודל משתמשת בתמונה בגודל 1024×1024. הדוגמה הזו היא תצורת דגימה, ולא טענה שכל משימה חייבת להיות ריבועית או ש־1024 פיקסלים הם המקסימום של המודל. בחרו את החיתוך ואת מבנה התצוגה הרצויים לפני הכנת הבריף החזותי, ואז השוו כיתוב עדין ומאפיינים קטנים בגודל הזה.

דוגמת ארבעת הצעדים שפורסמה משתמשת ב־guidance_scale 1.0. שמרו על הפרדה בין המהדורה המזוקקת הזו לבין FLUX.2 [klein] Base 4B, שאות האימון הלא מזוקק שלו מיועד להתאמה, לאימון LoRA ולמחקר. Base 4B ומודלי 9B הם אפשרויות נפרדות, עם שיקולי הכנה ודגימה שונים. הבקרות הרגילות של המודל הקומפקטי שונות גם מהצעדים ומההכוונה המתכווננים של [flex]; ל־[max] יש יכולת חיפוש משלו לעיגון במידע.

פרטים שיש לבדוק בתמונה

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

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

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

black-forest-labs/flux.2-klein-4b

Black Forest Labs /black-forest-labs/flux.2-klein-4b

התחלה

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

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

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

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

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

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

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

/v1/images

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

black-forest-labs/flux.2-klein-4b

FAQ · Black Forest Labs: FLUX.2 Klein 4B

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

Black Forest Labs: FLUX.2 Klein 4B