Black Forest Labs: FLUX.2 Flex

FLUX.2 [flex] เชี่ยวชาญตัวอักษรในภาพและรายละเอียดเล็ก พร้อมปรับขั้น sampling กับ guidance ใช้ข้อความและภาพอ้างอิงพัฒนาโปสเตอร์ เลย์เอาต์สินค้า หรือการแก้แม่นยำ โดยสมดุลการทำตามกับความสมจริง

Ailoot Ultra · รูปภาพ POST /v1/images/generations black-forest-labs/flux.2-flex

เกี่ยวกับโมเดล

คำอธิบายนี้ครอบคลุมความสามารถของโมเดล อินพุต เอาต์พุต และตัวเลือกที่ใช้ได้ใน Ailoot แสดงด้านล่างตามเมธอดที่เลือก

FLUX.2 [flex] เป็นรุ่นสร้างและแก้ภาพของ Black Forest Labs ที่เชี่ยวชาญ typography การเรนเดอร์ข้อความ และรักษารายละเอียดเล็ก ใช้คำสั่งฉากและภาพอ้างอิงสร้างภาพ จุดเด่นคือปรับ sampling ได้ โดยเปิดทั้ง inference steps และ guidance ทำให้ปรับบรีฟผ่านค่าตั้งร่วมกับถ้อยคำ

ตัวอักษรและรายละเอียดละเอียด

งานตัวอักษรควรเริ่มข้อความจริง ใส่แต่ละบรรทัดในเครื่องหมายคำพูด กำหนดตำแหน่ง แยกหัวเรื่อง ข้อความรอง และฉลาก บอกสไตล์ ขนาด และสีสัมพันธ์กับฉาก เช่น โปสเตอร์จักรยานน้ำเงินโคบอลต์ในสตูดิโออ่อน หัวเรื่องใหญ่เหนือเฟรมและบรรทัดข้อกำหนดเล็กด้านล่าง ภาพต้องทำให้สินค้าและลำดับอ่านชัดร่วมกัน

ภาพสินค้าละเอียดให้ระบุชิ้นที่ตัดสินประโยชน์ เช่น หน้าปัด ป้ายควบคุม ตะเข็บ ขอบวัสดุ หรือเครื่องหมายบรรจุภัณฑ์ ให้ภาพอ้างอิงอ่านได้และอธิบายคุณสมบัติที่กำหนด ฉากโดยรวมคล้ายก็ยังเปลี่ยนอักขระหรือชิ้นสำคัญได้ จึงเทียบรายละเอียดตามขนาดแสดง ความเชี่ยวชาญคือเหตุให้กำหนดชัด ไม่รับประกันว่าไม่ต้องพิสูจน์อักษรหรือตรวจภาพ

ขั้นและ guidance มีหน้าที่ต่างกัน

โปรไฟล์ตรงรับ inference หนึ่งถึงห้าสิบขั้น ค่าเริ่มต้นห้าสิบ คำอธิบายเชื่อมขั้นมากกับรายละเอียดและสมจริงมากขึ้น Guidance อยู่ 1.5–10 ค่าเริ่มต้น 5 ค่าสูงทำตามพรอมป์ต์มากขึ้นแต่อาจลดสมจริง งานคำสั่งออกแบบตรงกับงานภาพถ่ายธรรมชาติอาจเลือกค่าต่างกันในโปรไฟล์นี้

คงถ้อยคำ ภาพอ้างอิง และรูปทรงเอาต์พุตเมื่อเทียบการเปลี่ยนค่า ตรวจคุณสมบัติที่เป็นเหตุให้เปลี่ยน เช่น รูปอักษร ตำแหน่ง หรือพื้นผิว เปลี่ยนเพื่อเหตุผลภาพเฉพาะ แทนถือว่าตัวเลขใหญ่ดีกว่าเสมอ นี่คือตัวควบคุม sampling ผู้ผลิต ส่วน [klein] กลั่นสี่ขั้นกับตัวควบคุม [pro]/[max] เป็นคนละโมเดล

ข้อกำหนด [flex] เปิด prompt upsampling โดยปริยายและปิดผ่าน prompt_upsampling ของตนได้ เพื่อใช้บรีฟละเอียดตามข้อความเดิมเมื่อเหมาะ คู่มือร่วมแนะนำตัวแบบหลักและการกระทำสำคัญก่อนสิ่งตกแต่งรอง และอธิบายพรอมป์ต์ JSON ร่วมภาษาธรรมชาติ เลือกโครงที่ระบุความสัมพันธ์ได้ง่ายที่สุด

แก้ตามสื่ออ้างอิง

โปรไฟล์คำขอตรงมีภาพอ้างอิงแปดตำแหน่ง ส่วนโฟลว์โต้ตอบผู้ผลิตให้สูงสุดสิบภาพ เป็นคนละอินเทอร์เฟซ ระบุภาพใดให้ฉากที่แก้ สินค้า ตัวละคร เสื้อผ้า หรือสไตล์ งานแก้ระบุวัตถุกับการเปลี่ยน แล้วบอกองค์ประกอบ วัสดุ หรือแสงรอบข้างที่จะคง

งานบรรจุภัณฑ์ตัวอย่างใช้กล่องจากภาพแรกกับผิวจากภาพสอง แทนฉลากหน้าด้วยถ้อยคำที่อนุมัติ และคงสัดส่วนกล่อง องค์ประกอบกลุ่มกำหนดอ้างอิงแยกแต่ละตัวแบบอย่างสม่ำเสมอ ตัวอย่างตระกูลรวมเปลี่ยนวัตถุและพื้นหลัง คอมโพสิต แก้ข้อความ และสไตล์ ขอการแก้ที่เชื่อมเป็นเรื่องเดียวและเป้าชัด แล้วเทียบทั้งบริเวณแก้กับส่วนที่ต้องนิ่ง

ขนาด สี และภาพที่คืน

คู่มือ FLUX.2 ระบุขั้นต่ำ 64×64 พิกเซล ขนาดพหุคูณ 16 และสูงสุด 4 เมกะพิกเซล แนะนำงานทั่วไปไม่เกิน 2 เมกะพิกเซล ข้อกำหนด [flex] มี JPEG, PNG และ WebP ค่าเริ่มต้น JPEG และ random seed เสริม เก็บโมเดลจริง seed และค่า sampling กับภาพต้นทางเมื่อเทียบเวอร์ชัน ชื่อตระกูลอย่างเดียวไม่ระบุการตั้งค่าครบ

งานไวต่อสีให้ผูกแต่ละรหัส hex กับวัตถุหรือข้อความที่ตั้งชื่อ สำหรับองค์ประกอบกำหนดสัดส่วนด้วยขนาดภาพและเผื่อพื้นที่อักษรอ่านได้ คู่มือร่วมไม่มีกลไก negative-prompt จึงบอกสิ่งต้องการเชิงบวก เช่น โฟกัสคม พื้นหลังสะอาด หรือบริเวณว่างสำหรับข้อความ ตัวอย่างหลายภาษารองรับบรีฟเฉพาะวัฒนธรรมในภาษาที่เหมาะ แต่ไม่ได้รับประกันจำนวนภาษาตายตัว

โฟลว์ 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
ระดับการใช้เหตุผลสูงสุด: ไม่ได้ระบุ เมื่อใช้การปรับตามค่าเริ่มต้น (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 ของงานจาก ID การดำเนินการ และห้ามส่งคำขอสร้างซ้ำเด็ดขาด

ฟิลด์การตอบกลับ

ฟิลด์	ประเภท
ฟิลด์`created`	ประเภท
ฟิลด์`data[].url`	ประเภท
ฟิลด์`data[].b64_json`	ประเภท
ฟิลด์`usage`	ประเภท

ชื่ออื่น

ชื่ออื่นของโมเดล

Ailoot Ultra black-forest-labs/flux.2-flex

ชื่อพาธเมธอดอื่น

/v1/images

ID ที่เกี่ยวข้องสำหรับเรียกใช้โมเดล

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