mô hình
Bảng điều khiển

Black Forest Labs: FLUX.2 Pro

Markdown · JSON

Black Forest Labs: FLUX.2 Pro

FLUX.2 [pro] là mô hình hình ảnh phục vụ sản xuất của Black Forest Labs, dùng để tạo ảnh từ văn bản và chỉnh sửa theo ảnh tham chiếu. Cấu hình được công bố kết hợp chi tiết chân thực như ảnh chụp, khả năng kiểm soát chữ và màu với ngân sách điểm ảnh dùng chung cho tham chiếu và đầu ra, cùng ảnh tối đa 4 megapixel.

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 [pro] là mô hình tạo và chỉnh sửa hình ảnh hướng đến sản xuất của Black Forest Labs. Nhà sản xuất giới thiệu đây là lựa chọn mặc định cho phần lớn tác vụ hình ảnh FLUX.2: tạo ảnh mới từ văn bản hoặc sửa cảnh bằng tham chiếu thị giác. Các khả năng của dòng mô hình gồm chất liệu và ánh sáng chân thực như ảnh chụp, chữ dễ đọc, chỉ dẫn màu chính xác và chủ thể nhất quán qua các lần chỉnh sửa liên quan. Tài nguyên trả về là hình ảnh dùng cho cảnh sản phẩm, bố cục biên tập, ý tưởng thiết kế hoặc truyền thông thị giác.

Chuẩn bị bản yêu cầu sản xuất

Bắt đầu bằng chủ thể, hành động hoặc cách sắp xếp của chủ thể, phong cách và bối cảnh hoặc ánh sáng. Hướng dẫn viết câu lệnh của nhà sản xuất chú trọng hơn đến những từ ở đầu và khuyến nghị đặt chủ thể cùng hành động thiết yếu trước chi tiết trang trí. Hướng dẫn gợi ý 10–30 từ cho ý tưởng nhanh, 30–80 từ cho dự án thông thường và mô tả dài hơn cho cảnh phức tạp. Những khoảng này là hướng dẫn viết câu lệnh, không phải giới hạn ngữ cảnh văn bản.

Một bản yêu cầu ảnh danh mục tự soạn có thể mô tả đèn thép xước trên mặt bàn xám ấm, với góc nhìn ba phần tư làm rõ công tắc và chao đèn. Nêu bề mặt, ánh sáng và góc nhìn giúp nhận diện sản phẩm. Với đồ hoạ thông tin hoặc ảnh tiếp thị, hãy chốt nội dung chữ và thứ bậc trước; đặt tiêu đề chính xác trong dấu ngoặc kép, xác định vị trí và nêu phong cách cùng cỡ chữ. Kiểm tra nhãn, số lượng và chi tiết sản phẩm ở kích thước hiển thị cuối cùng.

Hướng dẫn của dòng mô hình công bố cả câu lệnh ngôn ngữ tự nhiên lẫn câu lệnh có cấu trúc JSON. Bản mô tả cảnh có cấu trúc có thể tách chủ thể, nền, ánh sáng và bố cục thành các trường riêng để sửa rõ ràng từng yêu cầu. Hướng dẫn cũng hỗ trợ mô tả màu bằng mã hex: gắn mã với vật thể hoặc đoạn chữ cụ thể cần tô màu. Mô tả diện mạo mong muốn theo cách khẳng định, vì quy trình viết câu lệnh FLUX.2 được công bố không cung cấp câu lệnh phủ định.

Chỉnh sửa bằng tham chiếu và ngân sách điểm ảnh dùng chung

Cấu hình yêu cầu [pro] cụ thể có tám vị trí ảnh tham chiếu; giao diện tương tác của nhà sản xuất hỗ trợ riêng mười ảnh. Giao vai trò cho mỗi ảnh, chẳng hạn diện mạo chủ thể, quần áo, thiết kế sản phẩm, căn phòng hoặc phong cách. Với cảnh có sẵn, nêu yếu tố cần thay đổi và bố cục, môi trường cùng chi tiết hình ảnh cần giữ. Ví dụ được công bố gồm ghép nội thất, đổi nền hoặc thời tiết, thay vật thể và sửa chữ.

Số lượng tham chiếu còn phụ thuộc kích thước đầu ra. Hướng dẫn [pro] của nhà sản xuất quy định tổng ngân sách 9 megapixel cho đầu vào cộng đầu ra. Các ví dụ cho phép tám tham chiếu khi đầu ra 1 megapixel và bảy khi đầu ra 2 megapixel, giảm sức chứa tham chiếu khi kết quả yêu cầu lớn hơn. Lập kế hoạch ảnh nguồn cùng đầu ra, thay vì coi số vị trí tối đa luôn dùng được ở mọi kích thước đầu ra. Dùng những tham chiếu cung cấp thông tin cần thiết và xác định đóng góp dự kiến của từng ảnh.

Với ảnh ghép sản phẩm, ảnh đầu có thể cung cấp sản phẩm, ảnh thứ hai cung cấp căn phòng, còn ảnh thứ ba xác định bề mặt chất liệu. Giải thích cách kết hợp chúng thành một cảnh thống nhất. Nếu kết quả làm đổi hình dạng, dấu hiệu hoặc danh tính cần giữ, hãy nhắm vào vấn đề đó trong lượt tiếp theo thay vì thay toàn bộ bản yêu cầu. Kết quả thực tế là ảnh đã sửa, được đối chiếu với đầu vào về độ trung thành với tham chiếu và thay đổi cụ thể.

Mở rộng câu lệnh và cấu hình cố định so với bản xem trước

Đặc tả [pro] cụ thể bật mở rộng câu lệnh theo mặc định. Tuỳ chọn disable_pup dừng việc mở rộng khi cần dùng nguyên chỉ dẫn đã soạn kỹ. Giữ thiết lập đã chọn khi so sánh các phiên bản, vì cùng một ý tưởng ngắn và mô tả đã mở rộng là những đầu vào tạo ảnh khác nhau. Đây là tuỳ chọn của cấu hình nhà sản xuất, không phải bảo đảm mọi chi tiết yêu cầu đều xuất hiện chính xác.

Tài liệu phân biệt điểm cuối [pro] thông thường là một bản chụp cố định với [pro] Preview, nơi các cải tiến mô hình tiếp theo được đưa vào. Cấu trúc yêu cầu và phản hồi giống nhau, còn trọng số nền khác nhau. Lưu cấu hình đã chọn chính xác cùng ảnh và tham chiếu. Nhãn Preview riêng không nên âm thầm thay thế lựa chọn [pro] thông thường khi lần sửa phụ thuộc vào cùng lựa chọn mô hình được công bố.

Kích thước, định dạng và tài nguyên đã chọn

Hướng dẫn của dòng mô hình công bố đầu ra tối đa 4 megapixel, với kích thước chỉ định ít nhất 64×64 và là bội số của 16. Hướng dẫn khuyến nghị tối đa 2 megapixel cho phần lớn trường hợp. Chiều rộng và chiều cao xác lập khung hình dự định; ảnh sản phẩm vuông, bố cục dọc và cảnh biên tập rộng phân bổ không gian khác nhau. Yêu cầu cụ thể liệt kê đầu ra JPEG, PNG và WebP, mặc định JPEG, cùng seed tuỳ chọn.

Cấu hình [max] có tính năng tìm kiếm làm căn cứ riêng, còn [flex] cung cấp số bước lấy mẫu và guidance, và [klein] có cấu hình nhỏ hơn với bốn tham chiếu. Chọn phiên bản theo công việc cần thực hiện thay vì đưa các tuỳ chọn đó vào [pro]. Với tài nguyên đã chọn, giữ ảnh thực tế, câu lệnh cuối cùng, tham chiếu, kích thước và nhãn mô hình. Liên kết kết quả FLUX.2 có chữ ký của nhà sản xuất hết hạn sau mười phút, nên hãy tải ảnh thay vì dựa vào vị trí tạm thời. Kiểm tra danh tính chủ thể, màu sắc, chữ, bố cục và chi tiết đã sửa trước khi đưa kết quả vào tài liệu dành cho khách hàng.

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

Bắt đầu

FLUX.2 [pro] là mô hình hình ảnh phục vụ sản xuất của Black Forest Labs, dùng để tạo ảnh từ văn bản và chỉnh sửa theo ảnh tham chiếu. Cấu hình được công bố kết hợp chi tiết chân thực như ảnh chụp, khả năng kiểm soát chữ và màu với ngân sách điểm ảnh dùng chung cho tham chiếu và đầu ra, cùng ảnh tối đa 4 megapixel.

Đầ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ườngLoạiYêu cầuGiá trị & giới hạnMặc định
TrườngmodelLoạistringYêu cầuBắt buộcGiá trị & giới hạn
black-forest-labs/flux.2-pro
Mặc định—
TrườngpromptLoạistringYêu cầuBắt buộcGiá trị & giới hạn
Độ dài tối thiểu: 1
Mặc định—
Trườngaspect_ratioLoạistringYêu cầuKhông bắt buộcGiá 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_formatLoạistringYêu cầuKhông bắt buộcGiá trị & giới hạn
png, jpeg
Mặc định—
TrườngnLoạiintegerYêu cầuKhông bắt buộcGiá trị & giới hạn
Tối thiểu: 1
Tối đa: 1
Mặc định—
Trườnginput_referencesLoạiarrayYêu cầuKhông bắt buộcGiá trị & giới hạn
Số mục tối thiểu: 0
Số mục tối đa: 8
Mặc định—
TrườngproviderLoạiobjectYêu cầuKhông bắt buộcGiá trị & giới hạnMặc định—
Tham số phương thức và vòng đời
Tham sốHợp đồng
Tham sốcontent_typeHợp đồngapplication/json
Tham sốrequiredHợp đồngmodel, prompt
Tham sốmaterial_typesHợ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ìnhBiểu mức phíSố lượng dự báoĐơn vị tính phíPhí
Cấu hìnhGiá cơ sở cho tokenBiểu mức phíMức phí cơ bảnSố 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 raBiểu mức phí—Số lượng dự báo—Đơn vị tính phímỗi megapixel ảnh đầu raPhí
Đầu ra · Megapixel của ảnh đầu ra · Ước tính chỉ để so sánh $0.06 mỗi megapixel ảnh đầu ra
Cấu hìnhChi phí tạo ước tínhBiể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.06 ướ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-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

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ườngLoại
TrườngcreatedLoại
Trườngdata[].urlLoại
Trườngdata[].b64_jsonLoại
TrườngusageLoại

Bí danh

Bí danh mô hình

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

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

/v1/images

ID gọi liên quan

black-forest-labs/flux.2-pro

FAQ · Black Forest Labs: FLUX.2 Pro
Có những đầu vào và kết quả nào?

POST /v1/images/generations · black-forest-labs/flux.2-pro: 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-pro: 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-pro: n.minimum: 1; n.maximum: 1

Xem thêm chi tiết

Kết nối Ailoot với Claude Code, OpenCode, Hermes hoặc ứng dụng của bạn.

Công ty và danh mục dự án của công ty

Công ty và danh mục dự án của công ty: hàng triệu khách hàng; doanh số hàng tỷ mỗi tháng.

Mua token với giá ưu đãi.

Ưu đãi thuê bao cho nhu cầu thường xuyên. Mã khuyến mãi giảm đến 50% khi mua token.

Thuê bao
Chọn gói ưu đãi cho các yêu cầu thường xuyên của bạn.
Mã giảm đến 50%
Nhập mã khi mua. Giá được tính lại theo chương trình đang áp dụng.
Chi phí trong lịch sử
Mô hình, token và số tiền được lưu cho mỗi yêu cầu.

Chọn gói thuê bao · Xem giá mô hình

Kết nối API vào sản phẩm bạn đang bán.

SaaS, ứng dụng và bot — theo đề nghị giao kết chính thức và thỏa thuận cấp phép Ailoot. Muốn bán lại, hãy yêu cầu giấy phép bán lại.

Ứng dụng thương mại
Tích hợp tạo văn bản, ảnh, video và âm thanh vào các tính năng trả phí của dịch vụ.
Giấy phép bán lại
Gửi mô tả dự án và cách cung cấp quyền truy cập. Yêu cầu điều khoản sử dụng và bán lại bằng văn bản.
Tài liệu trên website
Đề nghị giao kết, thỏa thuận cấp phép và chính sách xử lý dữ liệu có sẵn trước khi kết nối.

Yêu cầu giấy phép bán lại · Đề nghị giao kết và thỏa thuận cấp phép

Đăng nhậpĐăng kýBảng điều khiển
Bảng giá
Bắt đầu
Kết nối
API
API bảng điều khiển
Tích hợp
Thanh toán
Trợ giúp