Black Forest Labs: FLUX.2 Klein 4B

FLUX.2 [klein] 4B là mô hình hình ảnh gọn nhẹ, được chưng cất theo bước của Black Forest Labs, dùng để tạo ảnh từ văn bản và chỉnh sửa với tối đa bốn tham chiếu. Thiết kế bốn bước hỗ trợ công việc hình ảnh tương tác, đồng thời giữ danh tính riêng so với phiên bản Base 4B chưa chưng cất.

Ailoot Ultra · Ảnh POST /v1/images/generations black-forest-labs/flux.2-klein-4b

Về mô hình

Mô tả này trình bày khả năng của mô hình. Đầu vào, đầu ra và tùy chọn có trên Ailoot được liệt kê bên dưới cho phương thức đã chọn.

FLUX.2 [klein] 4B là mô hình gọn nhẹ của Black Forest Labs để tạo hình ảnh từ mô tả văn bản và chỉnh sửa ảnh bằng tham chiếu thị giác. Transformer rectified-flow bốn tỷ tham số đưa tạo ảnh và chỉnh sửa vào cùng một kiến trúc. Phiên bản 4B được nêu tên được chưng cất theo bước, và ví dụ tham chiếu của nhà sản xuất dùng bốn bước suy luận.

Vai trò của mô hình là tạo bản nháp hoặc bản sửa hình ảnh theo cách tương tác: khám phá cảnh sản phẩm, đổi trang phục nhân vật, kết hợp chủ thể với bối cảnh hoặc tinh chỉnh diện mạo tranh minh hoạ. Bắt đầu bằng sự kiện hoặc bố cục quan trọng, rồi mô tả chủ thể, chất liệu, ánh sáng và góc nhìn. Một bản yêu cầu cụ thể có thể đặt cốc gốm xanh lam mờ trên bàn gỗ sồi nhạt, với góc cận có ánh sáng bên giữ tay cầm và lớp men nhìn rõ. Kết quả là hình ảnh để kiểm tra theo những quyết định đó.

Chỉnh sửa với bộ tham chiếu nhỏ

Cấu hình 4B được công bố nhận tối đa bốn ảnh đầu vào. Giao vai trò rõ ràng cho từng ảnh: diện mạo sản phẩm, nhân vật, bối cảnh hoặc phong cách. Nếu một ảnh là cảnh cần sửa, xác định ảnh đó và nêu cả thay đổi lẫn chi tiết cần giữ. Chẳng hạn, giữ dáng và bề mặt cốc từ ảnh thứ nhất, dùng căn phòng từ ảnh thứ hai và chỉ thay vật phủ bàn. Thứ tự tham chiếu và chỉ dẫn thay đổi chính xác giúp lần sửa có mục tiêu rõ hơn so với yêu cầu cải thiện chung chung.

Nhà sản xuất phân biệt ngân sách tham chiếu gọn này với các biến thể FLUX.2 lớn hơn. Họ cũng nêu [klein] không có mở rộng câu lệnh. Tự cung cấp thông tin mô tả quan trọng, gồm quan hệ giữa các vật thể trong tham chiếu, thay vì dựa vào việc tự động mở rộng một nhãn ngắn. Với một chuỗi ảnh, giữ cùng tham chiếu chủ thể và yêu cầu hình ảnh, đồng thời mỗi lần chỉ đổi một quyết định về cảnh.

Thiết lập đầu ra và ranh giới giữa các phiên bản

Cấu hình 4B cụ thể của nhà sản xuất liệt kê đầu ra JPEG, PNG và WebP, mặc định JPEG. Giá trị chiều rộng và chiều cao chỉ định được công bố với mức tối thiểu 64 pixel mỗi chiều; ví dụ trong thẻ mô hình tham chiếu dùng ảnh 1024×1024. Ví dụ đó là cấu hình lấy mẫu, không khẳng định mọi tác vụ đều phải vuông hoặc 1024 pixel là mức tối đa của mô hình. Chọn vùng cắt và hình dạng hiển thị dự định trước khi chuẩn bị bản yêu cầu hình ảnh, rồi đối chiếu chữ nhỏ và đặc điểm nhỏ ở kích thước đó.

Ví dụ bốn bước được công bố dùng guidance_scale 1.0. Giữ phiên bản đã chưng cất này tách biệt với FLUX.2 [klein] Base 4B, có tín hiệu huấn luyện chưa chưng cất dành cho thích nghi, huấn luyện LoRA và nghiên cứu. Base 4B và các mô hình 9B là lựa chọn riêng, với cách chuẩn bị và cân nhắc lấy mẫu khác nhau. Các tuỳ chọn tiêu chuẩn của mô hình gọn cũng khác số bước và guidance điều chỉnh được của [flex]; [max] có khả năng tìm kiếm làm căn cứ riêng.

Chi tiết cần kiểm tra trong hình ảnh

Thẻ mô hình cụ thể nêu mô hình này không phải nguồn thông tin thực tế. Chữ viết trong ảnh có thể sai hoặc méo, và cảnh được tạo có thể lệch yêu cầu. Phong cách câu lệnh tác động đáng kể đến mức bám sát chỉ dẫn. Kiểm tra chính tả, số lượng, nhãn, danh tính chủ thể và các vật thể cụ thể cần giữ; bố cục hấp dẫn không xác lập rằng đặc tính sản phẩm hoặc sự thật được minh hoạ là đúng. Nhà sản xuất cũng lưu ý đầu ra thống kê có thể phản ánh thiên lệch của dữ liệu huấn luyện.

Với tài nguyên đã kiểm tra, lưu tham chiếu nguồn, nội dung cuối cùng và danh tính mô hình đã chọn cùng ảnh. Tài liệu phát hành phân biệt cách gắn thuỷ vân ở cấp điểm ảnh trong mã tham chiếu ví dụ với siêu dữ liệu xuất xứ C2PA được áp dụng trong quy trình đầu ra do nhà sản xuất lưu trữ. Giữ thông tin xuất xứ trả về giúp giải thích nguồn gốc tài nguyên; việc này tách biệt với kiểm tra thay đổi hình ảnh yêu cầu có thành công hay không.

Ailoot Ultra · Ảnh 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

Bắt đầu

Đầu vào được chấp nhận: Văn bản · Ảnh
Kết quả: Ảnh

Có trên Ailoot · đầu vào & phương thức

Ailoot Ultra · Ảnh POST /v1/images/generations

Đầu vào: text, image
Đầu ra: image

Trường	Loại	Yêu cầu	Giá trị & giới hạn	Mặc định
Trường`model`	Loại`string`	Yêu cầuBắt buộc	Giá trị & giới hạn black-forest-labs/flux.2-klein-4b	Mặc định—
Trường`prompt`	Loại`string`	Yêu cầuBắt buộc	Giá trị & giới hạn Độ dài tối thiểu: 1	Mặc định—
Trường`aspect_ratio`	Loại`string`	Yêu cầuKhông bắt buộc	Giá trị & giới hạn 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto	Mặc định—
Trường`output_format`	Loại`string`	Yêu cầuKhông bắt buộc	Giá trị & giới hạn png, jpeg	Mặc định—
Trường`n`	Loại`integer`	Yêu cầuKhông bắt buộc	Giá trị & giới hạn Tối thiểu: 1 Tối đa: 1	Mặc định—
Trường`input_references`	Loại`array`	Yêu cầuKhông bắt buộc	Giá trị & giới hạn Số mục tối thiểu: 0 Số mục tối đa: 4	Mặc định—
Trường`provider`	Loại`object`	Yêu cầuKhông bắt buộc	Giá trị & giới hạn	Mặc định—

Tham số phương thức và vòng đời

Tham số	Hợp đồng
Tham số`content_type`	Hợp đồngapplication/json
Tham số`required`	Hợp đồngmodel, prompt
Tham số`material_types`	Hợp đồngtext, image

Vòng đời: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · Giá trị task_id thực tế đã trả về hoặc bản ghi trong thư viện nội dung đa phương tiện

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Bảng giá

Cách tính phí cuối cùng

Các đơn giá hiển thị dùng để ước tính chi phí trước khi tạo. Khoản phí cuối cùng được tính dựa trên chi phí ghi nhận cho lượt tạo gốc. Thời lượng đầu ra đo được và số lượng dự kiến không phải là số lượng cuối cùng dùng để tính phí.

Thông tin biểu giá không bổ sung tùy chọn yêu cầu. Các tham số được hỗ trợ nằm trong phương thức đã chọn.

Chế độ nhanh: Chưa chỉ định Khi chọn chế độ nhanh
Chế độ Flex: Chưa chỉ định Khi chọn chế độ flex
Mức độ suy luận tối đa: Chưa chỉ định Khi áp dụng mức điều chỉnh mặc định (default) cho mức độ suy luận tối đa

Mức phí ước tính để so sánh

Giá theo cấu hình

Đối chiếu từng khoản phí với điều kiện hiển thị. Dùng một mức phí cho mỗi nhóm cấu hình thay thế.

Cấu hình	Biểu mức phí	Số lượng dự báo	Đơn vị tính phí	Phí
Cấu hìnhGiá cơ sở cho token	Biểu mức phíMức phí cơ bản	Số lượng dự báo—	Đơn vị tính phí—	Phí Đầu vào · Token đầu vào · Ước tính chỉ để so sánh — / 1K token Đầu ra · Token đầu ra · Ước tính chỉ để so sánh — / 1K token Đầu vào · Đọc bộ nhớ đệm · Ước tính chỉ để so sánh — / 1K token Đầu vào · Ghi bộ nhớ đệm · Ước tính chỉ để so sánh — / 1K token Đầu vào · Ghi bộ nhớ đệm, 1 giờ · Ước tính chỉ để so sánh — / 1K token
Cấu hìnhMegapixel của ảnh đầu ra	Biểu mức phí—	Số lượng dự báo—	Đơn vị tính phímỗi megapixel ảnh đầu ra	Phí Đầu ra · Megapixel của ảnh đầu ra · Ước tính chỉ để so sánh $0.028 mỗi megapixel ảnh đầu ra
Cấu hìnhChi phí tạo ước tính	Biểu mức phí—	Số lượng dự báoước tính cho một lần tạo	Đơn vị tính phí—	Phí Đầu ra · Chi phí tạo ước tính · Ước tính chỉ để so sánh $0.028 ước tính trước khi tạo Ước tính này không phải là khoản phí bổ sung hay mức giá cố định cho lượt tạo đã hoàn tất.

Ailoot tạm giữ một khoản ước tính trước yêu cầu. Sau khi có kết quả, phí cuối cùng được quyết toán theo mức sử dụng đo được. Việc quyết toán khi truyền luồng dùng bản ghi mức sử dụng cuối cùng. Cách hoạt động của cơ chế tạm giữ và quyết toán →

Ví dụ yêu cầu

Ailoot Ultra · Ảnh

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

Nhận và lưu kết quả

Ailoot Ultra · Ảnh

Tải xuống từng ảnh trả về hoặc lưu nội dung Base64 của ảnh

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Lượt đọc nội dung khác

Đọc tài nguyên hiện có thuộc về bạn

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.

Lưu tất cả kết quả đã hoàn tất

Lưu mọi ảnh đã hoàn tất; truy xuất từng URL trả về hoặc giải mã nội dung Base64 của ảnh.

Giữ lại toàn bộ phản hồi và các header, mọi đầu ra thực tế, các định danh gốc đã trả về và mọi trường usage. Khôi phục thao tác gốc mà không gửi lại yêu cầu tạo.

Nếu cần kiểm tra phản hồi gốc

Giữ lại X-Client-Request-ID đã trả về để đối soát. Chỉ truy xuất theo các giá trị task_id/asset_id thực tế đã trả về hoặc từ thư viện nội dung đa phương tiện thuộc quyền sở hữu của bạn; tuyệt đối không tạo URL tác vụ từ ID thao tác và không gửi lại yêu cầu tạo.

Trường phản hồi

Trường	Loại
Trường`created`	Loại
Trường`data[].url`	Loại
Trường`data[].b64_json`	Loại
Trường`usage`	Loại

Bí danh

Bí danh mô hình

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

Bí danh đường dẫn phương thức

/v1/images

ID gọi liên quan

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

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

Có những đầu vào và kết quả nào?: POST /v1/images/generations · black-forest-labs/flux.2-klein-4b: text, image → image
Yêu cầu sử dụng những trường nào?: POST /v1/images/generations · black-forest-labs/flux.2-klein-4b: model, prompt, aspect_ratio, output_format, n, input_references, provider
Áp dụng những giới hạn nào?: POST /v1/images/generations · black-forest-labs/flux.2-klein-4b: n.minimum: 1; n.maximum: 1

Black Forest Labs: FLUX.2 Klein 4B