Black Forest Labs: FLUX.3 Image

FLUX 3 Image tạo và chỉnh sửa ảnh từ bản yêu cầu bằng văn bản và tối đa mười tham chiếu. Mô hình bổ sung khung bao dựa trên câu lệnh cho bố cục và thay đổi cục bộ, dùng web và ảnh làm căn cứ, cùng năm nhóm độ phân giải.

Ailoot Ultra · Ảnh POST /v1/images/generations black-forest-labs/flux-3-image

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 3 Image là mô hình tạo và chỉnh sửa ảnh của Black Forest Labs với khả năng kiểm soát bố cục rõ ràng. Mô tả văn bản có thể tạo cảnh mới; ảnh cung cấp có thể xác lập chủ thể, cảnh cần sửa hoặc nhiều yếu tố cần kết hợp. Khung bao cho phép bản yêu cầu chỉ định vị trí từng yếu tố và phần nào của ảnh có sẵn cần thay đổi. Kết quả là hình ảnh có cảnh, chữ và bố cục yêu cầu để kiểm tra.

Tạo cảnh hoặc đưa chỉ dẫn chỉnh sửa

Với ảnh mới, mô tả chủ thể, hành động hoặc tư thế, bối cảnh, ánh sáng và khung hình. Đặt chữ chính xác cần xuất hiện trong ảnh vào dấu ngoặc kép và nêu vị trí. Một bản yêu cầu sản phẩm tự soạn có thể mô tả cốc cắm trại đỏ trên bề mặt đá nhạt, tiêu đề lớn phía trên và ánh sáng sớm dịu làm rõ tay cầm. Xác định quan hệ giữa tiêu đề, sản phẩm và nền thay vì đưa những từ phong cách rời rạc.

Khi chỉnh sửa, xác định vật thể cụ thể và thay đổi: đổi màu cốc, thay nhãn, di chuyển một người hoặc đổi phong cách cảnh. Một chỉnh sửa đơn lẻ không đòi hỏi vẽ khung thủ công. Quy trình được công bố mở rộng chỉ dẫn trước khi tạo ảnh và có thể tự định vị yếu tố được nêu tên rồi thêm khung. Câu lệnh đã mở rộng trả về ghi lại cách diễn giải đó, hữu ích khi chỉ dẫn chọn sai vật thể hoặc thêm chi tiết không mong muốn.

Kết hợp và chuẩn bị ảnh tham chiếu

Cấu hình cụ thể của nhà sản xuất nhận từ một đến mười tham chiếu, cung cấp dưới dạng URL ảnh hoặc dữ liệu ảnh đã mã hoá. Mỗi ảnh phải ít nhất 256×256 pixel và không lớn hơn 16 megapixel. Gọi tham chiếu theo vị trí hoặc nội dung nhìn thấy, rồi giải thích vai trò: người từ Image 1, áo khoác từ Image 2 và căn phòng từ Image 3. Ảnh tham chiếu là nguồn thông tin thị giác, không phải chỉ dẫn sao chép mọi chi tiết không liên quan trong ảnh.

Thiết lập tỷ lệ khung hình mặc định là auto. Trong đặc tả yêu cầu, tỷ lệ được yêu cầu trong câu lệnh được ưu tiên; nếu không, tham chiếu thứ nhất xác lập khung hình, với đầu ra vuông làm phương án dự phòng khi không có tham chiếu hay hình dạng yêu cầu. Với ảnh ghép, đặt tham chiếu cảnh dự định đầu tiên hoặc chọn tỷ lệ rõ ràng. Lưu ảnh nguồn và thứ tự cùng kết quả để lần sửa sau dùng cùng điểm xuất phát thị giác.

Đặt yếu tố bằng khung bao

Câu lệnh bố cục kết hợp một chú thích với mảng JSON chứa các hàng yếu tố. Chú thích gọi tên yếu tố qua ký hiệu như <cup_1>; hàng chứa id, bbox và desc. Toạ độ là số nguyên từ 0 đến 1000 theo thứ tự [top, left, bottom, right], đo từ góc trên bên trái. Chẳng hạn, [0, 0, 500, 500] mô tả một phần tư phía trên bên trái, bất kể kích thước điểm ảnh của ảnh. Dùng đúng tỷ lệ khung hình đã dùng khi thiết kế bố cục, vì lưới toạ độ co giãn theo khung.

Một hàng chỉnh sửa dùng from, src_bbox và tgt_bbox cùng mã định danh và mô tả. ref_image_0 là ảnh đầu tiên được cung cấp. Khung nguồn và đích trùng nhau neo yếu tố tại chỗ; khung khác nhau di chuyển hoặc đổi kích thước yếu tố. Hàng mới không có nguồn tạo nội dung mô tả ở vị trí đích, cho phép thêm, thay hoặc đổi màu. Hàng nguồn không có đích xoá yếu tố. Nêu phần thêm và xoá trong cả chỉ dẫn viết lẫn các hàng, và giữ các hàng neo cho chi tiết phải ở nguyên vị trí.

Cho chữ một khung riêng và đặt nội dung chính xác trong dấu ngoặc kép ở desc. Khung hướng dẫn vị trí và tỷ lệ; chúng không phải mặt nạ cắt, nên yếu tố có thể vượt ra ngoài hình chữ nhật. Nhà sản xuất báo cáo vật thể mới trong khung khoảng 40×25 pixel thường không xuất hiện trong ví dụ của họ. Chừa đủ không gian nhìn thấy và kiểm tra ranh giới đã sửa. Điểm ảnh ngoài vùng đích thường giữ ổn định, nhưng bóng, phản chiếu và ánh sáng lân cận vẫn có thể thay đổi.

Dùng thông tin làm căn cứ, nhóm đầu ra và hồ sơ hữu ích

Cấu hình được công bố bật dùng thông tin làm căn cứ theo mặc định, cho phép tìm kiếm web và ảnh cung cấp thông tin cho quá trình tạo ảnh. Có thể tắt với bản yêu cầu chỉ nên dùng mô tả và tham chiếu được cung cấp. Với chủ thể thực tế, xác định rõ địa điểm, sự kiện hoặc vật thể và tách nội dung dữ kiện khỏi cách thể hiện nghệ thuật. Ảnh dựa trên tìm kiếm vẫn cần đối chiếu với tài liệu có thẩm quyền khi nhãn, vật thể hoặc sự kiện được mô tả phải chính xác.

Năm nhóm độ phân giải là 768sq, 1k, 1.5k, 2k và 4k, mặc định 1k. Trong mỗi nhóm, tổng số điểm ảnh được giữ tương đương giữa các tỷ lệ khung hình, nên chiều rộng và chiều cao chính xác phụ thuộc tỷ lệ đã chọn. Mười lăm tỷ lệ cố định trải từ 21:9 qua định dạng vuông và dọc đến 9:21. Cấu hình mô hình này kiểm soát kích thước qua tỷ lệ và độ phân giải; không cung cấp các trường seed, width hoặc height dùng trong cấu hình yêu cầu FLUX.2. Bộ chọn phiên bản được công bố hiện nêu một bản phát hành thay đổi theo thời gian, thay vì xác lập sự khớp trọng số nhà cung cấp theo ngày cụ thể.

Quy trình của nhà sản xuất trả ảnh sau xử lý bất đồng bộ, cùng câu lệnh đã mở rộng. Liên kết tải ảnh có chữ ký có hiệu lực một giờ. Lưu ảnh thực tế, câu lệnh cuối cùng và tham chiếu thay vì dựa vào liên kết tạm thời. Với tài nguyên đã kiểm tra, đối chiếu chữ yêu cầu, vị trí vật thể, danh tính theo tham chiếu và vùng thay đổi ở kích thước hiển thị dự định. Quá trình tạo hoàn tất là điểm bắt đầu kiểm tra các yêu cầu hình ảnh đó.

Ailoot Ultra · Ảnh POST /v1/images/generations black-forest-labs/flux-3-image

black-forest-labs/flux-3-image

Black Forest Labs /black-forest-labs/flux-3-image

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-3-image	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`resolution`	Loại`string`	Yêu cầuKhông bắt buộc	Giá trị & giới hạn 768, 1K, 1.5K, 2K, 4K	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 21:9, 2:1, 16:9, 3:2, 7:5, 4:3, 5:4, 1:1, 4:5, 3:4, 5:7, 2:3, 9:16, 1:2, 9:21, auto	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: 10	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	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—	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ì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	Phí Đầu ra · Chi phí tạo ước tính · Ước tính chỉ để so sánh $0.082 ướ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-3-image', '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-3-image

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

/v1/images

ID gọi liên quan

black-forest-labs/flux-3-image

FAQ · Black Forest Labs: FLUX.3 Image

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

Black Forest Labs: FLUX.3 Image