Black Forest Labs: FLUX.2 Flex
FLUX.2 [flex] chuyên về kiểu chữ trong ảnh và chi tiết hình ảnh nhỏ, với số bước lấy mẫu và guidance có thể điều chỉnh. Dùng văn bản cùng ảnh tham chiếu để phát triển áp phích, bố cục sản phẩm hoặc chỉnh sửa chính xác, đồng thời cân bằng mức bám sát chỉ dẫn và tính chân thực.
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 [flex] là phiên bản tạo và chỉnh sửa ảnh của Black Forest Labs chuyên về kiểu chữ, kết xuất văn bản và giữ chi tiết nhỏ. Mô hình dùng chỉ dẫn cảnh bằng văn bản và ảnh tham chiếu để tạo ảnh. Tuỳ chọn đặc trưng là lấy mẫu có thể điều chỉnh: cấu hình được công bố cung cấp cả số bước suy luận và guidance, cho phép tinh chỉnh bản yêu cầu hình ảnh bằng thiết lập cũng như bằng từ ngữ.
Chữ và chi tiết nhỏ
Tác vụ kiểu chữ nên bắt đầu bằng nội dung thực tế. Đặt từng dòng trong dấu ngoặc kép, xác định vị trí và phân biệt tiêu đề, phần chữ bổ trợ cùng nhãn. Mô tả kiểu chữ, kích cỡ và màu trong quan hệ với cảnh. Một bản yêu cầu áp phích tự soạn có thể mô tả xe đạp xanh cobalt trong studio sáng màu, với tiêu đề lớn phía trên khung xe và dòng thông số nhỏ hơn phía dưới. Ảnh phải đồng thời làm rõ sản phẩm và thứ tự đọc.
Với hình ảnh sản phẩm chi tiết, xác định các phần quyết định kết quả có hữu ích hay không: mặt số, nhãn điều khiển, đường may, mép chất liệu hoặc dấu trên bao bì. Cung cấp tham chiếu dễ nhìn và giải thích đặc điểm nó xác lập. Cảnh nhìn chung tương tự vẫn có thể đổi ký tự hoặc bộ phận quan trọng, nên hãy đối chiếu chi tiết được tạo ở kích thước hiển thị dự định. Chuyên môn của mô hình là lý do để đưa yêu cầu chính xác, không phải bảo đảm không còn cần soát chữ hoặc kiểm tra hình ảnh.
Số bước và guidance có mục đích khác nhau
Cấu hình cụ thể của nhà sản xuất nhận từ một đến năm mươi bước suy luận, mặc định năm mươi. Mô tả của cấu hình liên hệ nhiều bước hơn với chi tiết và tính chân thực cao hơn. Guidance nằm trong khoảng 1.5 đến 10, mặc định 5. Guidance cao hơn tăng mức bám sát câu lệnh nhưng có thể giảm tính chân thực. Vì vậy, ảnh có chỉ dẫn thiết kế chính xác và ảnh hướng tới vẻ tự nhiên như nhiếp ảnh có thể cần các lựa chọn khác nhau trong cấu hình đó.
Giữ nguyên nội dung, tham chiếu và hình dạng đầu ra khi so sánh thay đổi thiết lập. Xem đặc điểm khiến bạn điều chỉnh: hình dáng chữ, vị trí vật thể hoặc kết cấu chất liệu. Đổi thiết lập vì một lý do hình ảnh cụ thể, thay vì coi số lớn luôn tốt hơn. Đây là các tuỳ chọn lấy mẫu của nhà sản xuất; cấu hình [klein] đã chưng cất bốn bước và các tuỳ chọn tiêu chuẩn của [pro] hoặc [max] là lựa chọn mô hình khác.
Mở rộng câu lệnh được bật mặc định trong đặc tả [flex] và có thể tắt bằng tuỳ chọn prompt_upsampling riêng. Điều này cho phép giữ bản yêu cầu chi tiết đúng như văn bản cung cấp khi phù hợp. Hướng dẫn chung của nhà sản xuất khuyến nghị đặt chủ thể chính và hành động quan trọng trước trang trí phụ, đồng thời mô tả câu lệnh có cấu trúc JSON bên cạnh bản yêu cầu ngôn ngữ tự nhiên. Dùng cấu trúc giúp dễ chỉ định nhất các quan hệ cần thiết.
Chỉnh sửa dựa trên tham chiếu
Cấu hình yêu cầu cụ thể có tám vị trí ảnh tham chiếu. Quy trình tương tác của nhà sản xuất cho phép riêng tối đa mười ảnh; các con số này mô tả các giao diện khác nhau. Xác định ảnh cung cấp cảnh cần sửa, sản phẩm, nhân vật, quần áo hay phong cách. Với một lần sửa, xác định vật thể và thay đổi, rồi nêu bố cục, chất liệu hoặc ánh sáng xung quanh cần giữ.
Một tác vụ bao bì tự soạn có thể dùng hộp từ ảnh thứ nhất và bề mặt hoàn thiện từ ảnh thứ hai, thay nhãn trước bằng nội dung đã duyệt và giữ tỷ lệ hộp. Bố cục nhóm có thể giao một tham chiếu riêng cho mỗi chủ thể và giữ các phân công đó nhất quán. Ví dụ của dòng mô hình bao gồm thay vật thể và nền, ghép ảnh, sửa chữ và chuyển phong cách. Yêu cầu một lần sửa liên kết với mục tiêu rõ ràng, rồi đối chiếu cả vùng đã sửa và phần cần giữ ổn định.
Kích thước, màu sắc và ảnh trả về
Hướng dẫn FLUX.2 công bố mức tối thiểu 64×64 pixel, kích thước là bội số của 16 và đầu ra tối đa 4 megapixel, với khuyến nghị tối đa 2 megapixel cho sử dụng thông thường. Đặc tả [flex] cụ thể liệt kê đầu ra JPEG, PNG và WebP, mặc định JPEG. Cấu hình cũng cung cấp seed ngẫu nhiên tuỳ chọn. Lưu mô hình thực tế, seed và thiết lập lấy mẫu cùng tham chiếu nguồn khi so sánh các phiên bản; chỉ tên dòng mô hình chưa xác định cấu hình tạo ảnh đầy đủ.
Với công việc nhạy về màu, gắn từng mã hex với vật thể hoặc đoạn chữ được nêu tên. Với bố cục, chỉ định tỷ lệ khung hình dự định qua kích thước ảnh và chừa đủ chỗ cho chữ dễ đọc. Hướng dẫn chung không có cơ chế câu lệnh phủ định, nên mô tả diện mạo mong muốn theo cách khẳng định: nét rõ, nền sạch hoặc vùng trống rõ ràng dành cho nội dung chữ. Ví dụ đa ngôn ngữ hỗ trợ viết bản yêu cầu mang đặc trưng văn hoá bằng ngôn ngữ phù hợp, nhưng không xác lập bảo đảm về một số lượng ngôn ngữ cố định.
Quy trình FLUX.2 của nhà sản xuất trả ảnh sau xử lý và dùng liên kết có chữ ký tạm thời với khoảng thời gian tải về mười phút. Lưu ảnh thực tế cùng bản yêu cầu. Kiểm tra kiểu chữ, chi tiết nhỏ, danh tính theo tham chiếu và cách thể hiện hình ảnh trước khi đặt tài nguyên vào bố cục. Sản phẩm bàn giao có thể là áp phích đã chọn, ảnh sản phẩm hoặc bố cục đã sửa, với thiết lập chính xác được giữ cho lần sửa tiếp theo.
Ailoot Ultra · Ảnh POST /v1/images/generations black-forest-labs/flux.2-flex
black-forest-labs/flux.2-flexBắt đầu
FLUX.2 [flex] chuyên về kiểu chữ trong ảnh và chi tiết hình ảnh nhỏ, với số bước lấy mẫu và guidance có thể điều chỉnh. Dùng văn bản cùng ảnh tham chiếu để phát triển áp phích, bố cục sản phẩm hoặc chỉnh sửa chính xác, đồng thời cân bằng mức bám sát chỉ dẫn và tính chân thực.
- Đầ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ườngmodel | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn black-forest-labs/flux.2-flex | Mặc định— |
Trườngprompt | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn Độ dài tối thiểu: 1 | Mặc định— |
Trườngaspect_ratio | Loạistring | 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ườngoutput_format | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn png, jpeg | Mặc định— |
Trườngn | Loạiinteger | 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ườnginput_references | Loạiarray | 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: 8 | Mặc định— |
Trườngprovider | Loạiobject | 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 vào | Biểu mức phí— | Số lượng dự báo— | Đơn vị tính phímỗi megapixel ảnh đầu vào | Phí Đầu vào · Megapixel của ảnh đầu vào · Ước tính chỉ để so sánh $0.12 mỗi megapixel ảnh đầu vào |
| 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.12 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.12 ướ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
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
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}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Lượt đọc nội dung khác
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ườngcreated | Loại |
Trườngdata[].url | Loại |
Trườngdata[].b64_json | Loại |
Trườngusage | Loại |
Bí danh
Bí danh mô hình
Ailoot Ultra black-forest-labs/flux.2-flex
Bí danh đường dẫn phương thức
/v1/images
ID gọi liên quan
FAQ · Black Forest Labs: FLUX.2 Flex
- Có những đầu vào và kết quả nào?
POST /v1/images/generations·black-forest-labs/flux.2-flex: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-flex: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-flex:n.minimum:1;n.maximum:1