API FLUX 3 Image
FLUX 3 Image của Black Forest Labs đẩy điều khiển sinh ảnh xuống mức pixel: đặt từng phần tử bằng bounding box, chỉnh sửa theo vùng trong khi phần còn lại giữ nguyên từng pixel, và render gốc từ 768sq đến 4K. Roko API cung cấp qua tác vụ bất đồng bộ, từ $0.041 mỗi request 768sq.
- ID mô hình công khai
flux-3-image- Bậc đầu ra
768sq / 1K / 1.5K / 2K / 4K (mặc định 1K)- Thanh toán
Theo request theo độ phân giải- Endpoint
POST /v1/images/tasks- Ảnh chụp danh mục
FLUX 3 Image là gì?
FLUX 3 Image là mô hình tạo và chỉnh sửa ảnh do Black Forest Labs phát hành ngày 1/10/2026 với khẩu hiệu "kiểm soát từng pixel". Điểm khác biệt là bố cục theo bounding box: canvas được trừu tượng hóa thành lưới tọa độ chuẩn hóa 0–1000, và bạn khoanh từng phần tử một hộp kèm mô tả ở cuối prompt; kết quả tuân thủ các ràng buộc vị trí đó.
Chỉnh sửa cũng theo hộp: thay đổi trên ảnh hoàn thiện được làm hộp này đến hộp khác qua nhiều vòng, và mọi thứ ngoài các hộp đã sửa giữ nguyên từng pixel, giới hạn lỗi vẽ lại trong phạm vi cục bộ. Mô hình nhận tối đa 10 ảnh tham chiếu (đặt tên theo vị trí trong prompt) cùng grounding — tra cứu web để làm giàu prompt.
Roko hiện công bố năm bậc độ phân giải (768sq, 1K, 1.5K, 2K, 4K) và 16 tỷ lệ khung hình, tính tiền theo request theo độ phân giải đã chọn ($0.041 ở 768sq đến $0.607 ở 4K). Khi kiểm tra, các mức này trùng giá niêm yết BFL, nhưng thanh toán Roko luôn theo danh mục dự án hiện tại. Lệnh gọi chạy theo tác vụ bất đồng bộ: gửi, nhận task_id, rồi polling.
Năng lực chính
Bố cục theo bounding box
Đặt từng phần tử trên lưới tọa độ chuẩn hóa và mô tả theo hộp — biến việc sinh ảnh từ bài toán đúng prompt thành bài toán đúng bố cục.
Chỉnh sửa cục bộ theo hộp
Sửa ảnh hoàn thiện từng hộp một qua nhiều vòng; vùng không đụng tới giữ nguyên từng pixel, tránh lệch toàn ảnh.
Hòa trộn 10 ảnh tham chiếu
Kết hợp tối đa 10 ảnh tham chiếu, đặt tên theo vị trí trong prompt, để mô hình tự sắp xếp và render chung.
4K gốc và 16 tỷ lệ khung hình
Năm bậc gốc từ 768sq đến 4K (~16,8 megapixel) trên 16 tỷ lệ khung hình — 4K giữ chi tiết khi phóng to.
Giá API FLUX 3 Image
Giá lấy từ danh mục Roko hiện tại và tính theo request theo độ phân giải đã chọn. Tại thời điểm kiểm tra, con số trùng giá niêm yết BFL, nhưng giá hay khuyến mãi thượng nguồn không quyết định thanh toán Roko; hãy xác nhận mức dự tính và bản ghi cuối của Roko.
| Độ phân giải | Giá | Đơn vị tính |
|---|---|---|
| 768sq | $0.041 | mỗi ảnh |
| 1k | $0.048 | mỗi ảnh |
| 1.5k | $0.07 | mỗi ảnh |
| 2k | $0.1 | mỗi ảnh |
| 4k | $0.607 | mỗi ảnh |
Ví dụ chi phí
Bậc mặc định — chi phí chuẩn cho ảnh web và mạng xã hội.
Bậc gốc cao nhất cho in ấn và định dạng lớn; tính theo request, request lỗi không tính tiền.
Tham số và phạm vi hỗ trợ
Các trường lấy từ generation_config công khai hiện tại. Cú pháp bounding box viết ở cuối prompt (tọa độ chuẩn hóa 0–1000); năng lực ngoài biểu mẫu phụ thuộc xác thực request.
| Tham số | Giá trị | Ghi chú |
|---|---|---|
prompt | textarea | Mô tả hình ảnh cần tạo hoặc các thay đổi muốn áp dụng cho ảnh tham chiếu. · Bắt buộc |
images | url / base64 · 1–10 | Ảnh tham chiếu có thể dùng URL hoặc Base64; giới hạn hiện hành được hiển thị trong trường của mô hình. · Tùy chọn |
aspect_ratio | auto / 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 | Chọn tỷ lệ khung hình đầu ra; auto để mô hình tự quyết định. · Mặc định: auto · Tùy chọn |
resolution | 768sq / 1k / 1.5k / 2k / 4k | Chọn bậc độ phân giải được cấu hình cho mô hình; giá trị này có thể ảnh hưởng trực tiếp đến giá. · Mặc định: 1k · Tùy chọn |
safety_tolerance | 0–4 | Roko hiện mở mức 0–4: 0 nghiêm ngặt nhất, 4 nới lỏng nhất; mặc định 2. · Mặc định: 2 · Tùy chọn |
grounding | boolean | Khi bật, mô hình có thể tra cứu web để làm giàu prompt; bật theo mặc định. · Mặc định: true · Tùy chọn |
Gọi FLUX 3 Image qua Roko API
Chạy theo luồng tác vụ bất đồng bộ: gửi tác vụ để nhận task_id, rồi polling kết quả. Không để lộ API key trong code phía client.
Gửi yêu cầu tạo ảnh
curl https://api.rokoapi.com/v1/images/tasks \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
-d '{
"model": "flux-3-image",
"prompt": "Modern city park poster: bounding boxes — fountain center (400,500)-(600,800), skyscrapers background left (0,0)-(350,700), oak trees background right (650,100)-(1000,750)",
"aspect_ratio": "16:9",
"resolution": "1k"
}'Truy vấn tác vụ khôi phục
curl https://api.rokoapi.com/v1/tasks/$TASK_ID \
-H "Authorization: Bearer $API_KEY"POST /v1/images/tasks trả về 202 kèm task_id; sau khi tạo ảnh xong, truy vấn GET /v1/tasks/{task_id} để xem kết quả hoặc nguyên nhân lỗi. Idempotency-Key phải duy nhất; gửi lại với cùng key sẽ trả về tác vụ gốc và không tính thêm tiền.
Kịch bản phù hợp
Bố cục và poster chính xác
Tiêu đề, chủ thể và nền đều tuân theo ràng buộc hộp — phù hợp bố cục quảng cáo và dàn trang poster.
Poster: product bottle center, headline text box top-left, lifestyle scene bottom — each element in its own bounding box.
Tinh chỉnh cục bộ nhiều vòng
Sửa từng hộp với vùng xung quanh giữ nguyên pixel — hợp quy trình final cần duyệt đi duyệt lại.
Edit only the bounding box around the logo: replace with the new wordmark, keep everything else pixel-identical.
Tổng hợp cảnh từ nhiều tham chiếu
Hòa người, sản phẩm và bối cảnh từ nhiều ảnh tham chiếu vào một ảnh bố cục theo hộp.
Combine the model from image 1, the outfit from image 2, and the studio background from image 3 into one composition.
In ấn 4K và định dạng lớn
4K gốc (~16,8 MP) giữ chi tiết khi phóng — backdrop hội chợ và tư liệu in.
Trade-show backdrop at 4K: brand hero center, product lineup along the bottom edge, clean gradient background.
Giới hạn cần biết trước khi dùng
- Tính tiền theo request và bậc 4K ($0.607) đắt hơn hẳn các bậc thấp — bản nháp số lượng lớn nên dùng 768sq hoặc 1K.
- Bounding box dùng tọa độ chuẩn hóa 0–1000 viết ở cuối prompt; cú pháp sai sẽ bị coi là văn bản thường hoặc bị xác thực request từ chối.
- Roko hiện giới hạn safety_tolerance trong khoảng 0–4 (0 nghiêm ngặt nhất, 4 nới lỏng nhất), mặc định 2; xác nhận tuân thủ trước khi nâng.
- Gửi tác vụ thành công không đồng nghĩa tạo ảnh thành công — hãy tin kết quả truy vấn tác vụ và kiểm tra kỹ đầu ra trước khi dùng.
FLUX 3 Image hay mô hình ảnh khác?
Chọn FLUX 3 cho bố cục chính xác và chỉnh sửa theo vùng; họ Seedream hợp cảnh tiếng Trung và bộ ảnh; GPT Image 2.5 hợp nền trong suốt và nội dung thường ngày. Cân nhắc mức kiểm soát, độ phân giải và giá.
Tất cả mô hình →Câu hỏi thường gặp về FLUX 3 Image
ID mô hình của FLUX 3 Image API là gì?
Dùng ID công khai của Roko API: flux-3-image, nguyên văn trong trường model.
FLUX 3 Image API giá bao nhiêu?
Tính theo request theo độ phân giải đã chọn: $0.041 ở 768sq, $0.048 ở 1K, $0.07 ở 1.5K, $0.10 ở 2K, $0.607 ở 4K. Khi kiểm tra, các mức này trùng giá niêm yết BFL, nhưng thanh toán Roko theo dự tính của dự án và bản ghi cuối khi gửi.
Bố cục bounding box dùng thế nào?
Sách thức chính thức chuẩn hóa canvas về 0–1000 và đặt ở cuối prompt một hộp kèm mô tả cho từng phần tử, ví dụ "fountain (400,500)-(600,800)". Kết quả tuân thủ các ràng buộc vị trí đó.
Chỉnh sửa theo hộp nghĩa là gì?
Bạn sửa ảnh hoàn thiện từng hộp một: chỉ vùng trong hộp được vẽ lại, phần còn lại giữ nguyên từng pixel, có thể lặp nhiều vòng mà không lệch toàn ảnh.
Hỗ trợ những độ phân giải và tỷ lệ nào?
Roko hiện công bố 768sq, 1K, 1.5K, 2K, 4K cùng 16 tỷ lệ khung hình (mặc định auto). 4K khoảng 16,8 megapixel — render gốc chứ không phải phóng to.
Gọi FLUX 3 Image qua endpoint nào?
Gửi tác vụ bất đồng bộ qua POST /v1/images/tasks để nhận task_id, rồi polling GET /v1/tasks/{task_id} để xem kết quả hoặc nguyên nhân lỗi.
Tham số grounding làm gì?
Khi bật grounding, mô hình có thể tra cứu web để bổ sung thông tin prompt (sự kiện thời gian thực, mô tả tư liệu thương hiệu). Mặc định bật; không cần thì tắt tường minh.
Có dùng được trọng số mở không?
Tại lần xác minh gần nhất (06-10-2026), BFL cho biết trọng số mở sẽ ra trong vài tuần tới; trọng số thương mại cần cấp phép riêng. Trên Roko, request chạy qua kênh API chính thức của BFL.