API FLUX 3 Image
Roko cung cấp FLUX 3 Klein qua Kie AI với ID flux-3-image. Không gửi ảnh tham chiếu để tạo ảnh từ văn bản; gửi ảnh để tự động chọn chỉnh sửa. Hỗ trợ 1K, 2K, 4K và 1–4 ảnh mỗi yêu cầu.
- ID mô hình công khai
flux-3-image- Bậc đầu ra
1K / 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ì?
ID công khai flux-3-image hiện dùng FLUX 3 Klein qua Kie AI, không cung cấp toàn bộ tính năng của API FLUX 3 Image bản đầy đủ từ BFL.
Giữ nguyên ID: không có ảnh tham chiếu thì tạo ảnh mới; gửi 1–10 URL ảnh công khai để tự động chọn chỉnh sửa.
Chọn 1K, 2K hoặc 4K và 1–4 ảnh đầu ra. Gửi tác vụ bất đồng bộ rồi truy vấn kết quả; phí dựa trên độ phân giải và số ảnh tạo thành công.
Năng lực chính
Tạo ảnh từ văn bản
Mô tả chủ thể, phông nền và phong cách; hệ thống tự chọn mô hình phù hợp.
Chỉnh sửa ảnh tham chiếu
Gửi 1–10 ảnh, nêu rõ phần cần thay đổi và giữ lại, rồi kiểm tra kết quả.
Nhiều ảnh đầu ra
n nhận 1–4; phí được quyết toán theo số ảnh thành công.
Ba mức phân giải
Chọn 1K, 2K hoặc 4K cùng tỷ lệ khung hình được hỗ trợ.
Giá API FLUX 3 Image
Giá lấy từ danh mục Roko hiện tại và tính theo ảnh đầu ra theo độ phân giải đã chọn. Tại thời điểm kiểm tra, con số trùng giá tiêu chuẩn Kie AI, 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 |
|---|---|---|
| 1k | $0.01 | mỗi ảnh |
| 2k | $0.016 | mỗi ảnh |
| 4k | $0.036 | 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.
Quyết toán theo số ảnh thành công. Phép tính dùng giá tại thời điểm ghi nhận hiện tại.
Tham số và phạm vi hỗ trợ
Các trường dựa trên cấu hình Kie hiện tại. Ảnh tham chiếu cần URL HTTP / HTTPS công khai. Không cung cấp tham số bố cục bằng khung riêng, grounding hoặc safety_tolerance.
| 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 · 1–10 | Dùng tối đa 10 URL ảnh HTTP / HTTPS công khai. Không nhận Base64 hoặc địa chỉ blob: của trình duyệt. · Tùy chọn |
aspect_ratio | auto / 1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3 / 21:9 / 9:21 | Khi chỉnh sửa, auto theo ảnh tham chiếu. Khi tạo từ văn bản, bỏ qua hoặc đặt auto sẽ dùng 1:1. · Mặc định: auto · Tùy chọn |
resolution | 1k / 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 |
n | 1–4 | Số ảnh tạo ra mỗi request; càng nhiều kết quả chi phí càng cao. · Mặc định: 1 · Tùy chọn |
output_format | png / jpeg / webp | Định dạng tệp của ảnh tạo ra: png hoặc jpeg. · Mặc định: png · Tùy chọn |
enhance_prompt | boolean | Tùy chọn |
seed | integer | 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": "A ceramic mug on a white studio background, soft side lighting.",
"aspect_ratio": "16:9",
"resolution": "2k"
}'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
Phác thảo cảnh sản phẩm
Mô tả sản phẩm, ánh sáng và phông nền; kiểm tra bố cục ở 1K trước.
A ceramic mug on a white studio background, soft side lighting.
Đổi phông nền và màu sắc
Gửi ảnh tham chiếu và chỉ dẫn cụ thể; không giả định mọi pixel khác đều được giữ nguyên.
Change the mug to blue while keeping its shape and the white background.
Kết hợp nhiều ảnh tham chiếu
Nêu rõ chủ thể, phong cách hoặc bối cảnh mà từng ảnh cung cấp.
Use the product from image 1 and the background from image 2.
Khám phá phương án
Dùng n để yêu cầu tối đa bốn ảnh rồi kiểm tra và chọn phiên bản phù hợp.
Create alternative studio compositions of a ceramic mug.
Giới hạn cần biết trước khi dùng
- Dùng 1–10 URL HTTP / HTTPS công khai; không nhận Base64, Data URL hoặc địa chỉ blob:.
- Có chín tỷ lệ cố định. Chỉnh sửa hỗ trợ auto; tạo từ văn bản dùng 1:1 khi bỏ qua tỷ lệ hoặc đặt auto.
- Kết nối Klein không bảo đảm giữ nguyên từng pixel ngoài vùng chỉnh sửa và không cung cấp tham số bố cục hay tìm kiếm web riêng của API đầy đủ.
- Gửi thành công chỉ có nghĩa là tác vụ đã được nhận. Truy vấn đến trạng thái cuối và kiểm tra ảnh trước khi sử dụng.
FLUX 3 Image hay mô hình ảnh khác?
Chọn theo tác vụ, giới hạn ảnh tham chiếu, độ phân giải và giá trong danh mục hiện tại. Trang này không báo cáo so sánh chất lượng hoặc tốc độ trong cùng điều kiện.
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 ảnh đầu ra theo độ phân giải đã chọn: $0.008 ở 1K, $0.0125 ở 2K, $0.0325 ở 4K. Khi kiểm tra, các mức này trùng giá tiêu chuẩn Kie AI, nhưng thanh toán Roko theo dự tính của dự án và bản ghi cuối khi gửi.
Có cần đổi ID khi chỉnh sửa không?
Không. Giữ flux-3-image: không có ảnh tham chiếu để tạo ảnh, có ảnh tham chiếu để tự động chọn chỉnh sửa.
Gửi ảnh tham chiếu thế nào?
Gửi 1–10 URL ảnh HTTP / HTTPS công khai trong image_urls hoặc images. Cũng hỗ trợ image và input_reference.
Hỗ trợ độ phân giải và tỷ lệ nào?
1K, 2K, 4K; các tỷ lệ cố định là 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9 và 9:21. Chỉnh sửa hỗ trợ auto; auto khi tạo từ văn bản dùng 1:1.
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.
Đây có phải API BFL đầy đủ không?
Kết nối này dùng FLUX 3 Klein qua Kie AI, không cung cấp tham số bố cục bằng khung hoặc tìm kiếm web riêng; không nên suy ra toàn bộ năng lực của API đầy đủ.
Mỗi tác vụ tạo được bao nhiêu ảnh?
n nhận 1–4, mặc định 1. Phí dựa trên số ảnh thành công và độ phân giải đã chọn.