Black Forest Labs: FLUX.2 Pro

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

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

על המודל

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

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

הכינו בריף להפקה

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

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

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

ערכו עם ייחוסים ותקציב פיקסלים משותף

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

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

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

הרחבת הנחיה ופרופילים קבועים לעומת Preview

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

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

ממדים, פורמטים והנכס שנבחר

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

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

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

black-forest-labs/flux.2-pro

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

התחלה

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

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

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

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

שדה	סוג	דרישה	ערכים ומגבלות	ברירת מחדל
שדה`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}

תעריפים

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

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

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

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

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

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

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

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

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

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

/v1/images

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

black-forest-labs/flux.2-pro

FAQ · Black Forest Labs: FLUX.2 Pro

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

Black Forest Labs: FLUX.2 Pro