Source: https://ailoot.ai/models/vi/black-forest-labs-flux-3-image/ Canonical: https://ailoot.ai/models/vi/black-forest-labs-flux-3-image/ Language: vi # Black Forest Labs: FLUX.3 Image [Markdown](https://ailoot.ai/models/vi/black-forest-labs-flux-3-image/index.md) · [JSON](https://ailoot.ai/models/vi/black-forest-labs-flux-3-image/facts.json) ## [Black Forest Labs: FLUX.3 Image](https://ailoot.ai/models/vi/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`](https://ailoot.ai/models/vi/black-forest-labs-flux-3-image/#method-0) 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ư \; 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`](https://ailoot.ai/models/vi/#m=black-forest-labs%2Fflux-3-image&route=Ultra&caller=black-forest-labs%2Fflux-3-image&fmt=images) Black Forest Labs /`black-forest-labs/flux-3-image` ### Bắt đầu 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. Đầ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 →](https://ailoot.ai/docs/vi/billing/reserve/) ### Ví dụ yêu cầu #### Ailoot Ultra · Ảnh curl ```bash 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"