Xây dựng với CometAPICần một API cho nhiều mô hình?Kiểm thử quy trình trong Playground, sau đó tạo API key khi mô hình và chi phí phù hợp với trường hợp sử dụng của bạn.
Tạo ảnh sản phẩm, poster và các chỉnh sửa dựa trên tham chiếu với FLUX 3 Image, khả dụng qua CometAPI với ID flux-3-image, giá từ $0.0384 mỗi yêu cầu. Hướng dẫn này giúp bạn chọn thiết lập ảnh, chuẩn bị yêu cầu, xử lý job bất đồng bộ và rà soát ảnh hoàn thiện. Bạn cần tài khoản CometAPI, khóa API và cấu hình yêu cầu FLUX 3 Image được cấp cho tài khoản của bạn.
Key Takeaways
Chọn text-to-image cho tác phẩm mới và chỉnh sửa có hướng dẫn bằng tham chiếu khi cần giữ nguyên nhận diện sản phẩm hoặc chủ thể.
Dùng bản nháp nhỏ để duyệt bố cục trước khi chi cho ảnh cuối lớn.
Sử dụng thông tin xác thực CometAPI và schema yêu cầu riêng theo model; khóa và ví dụ gốc của BFL thuộc một tích hợp riêng.
Ước tính chi phí theo mức giá CometAPI áp dụng, rồi đo lường chi tiêu trên mỗi sản phẩm được chấp nhận.
Đã được xem xét về độ rõ ràng, ghi nguồn và thuật ngữ API hiện tại.
Hoàn tất một vòng nộp, lấy kết quả, tải xuống và duyệt trực quan trước khi chạy hàng loạt.
What Is FLUX 3 Image API?
FLUX 3 Image là model của Black Forest Labs để tạo và chỉnh sửa ảnh tĩnh. Prompt văn bản mô tả một cảnh mới; ảnh tham chiếu cung cấp vật liệu thị giác để giữ nguyên, kết hợp hoặc thay đổi. Với đội e-commerce, điều này có thể là phát triển cảnh sản phẩm từ brief, rồi tái dùng ảnh sản phẩm đã duyệt trong khi thay đổi bối cảnh.
Hãy chọn quy trình trước khi viết prompt. Với hình ảnh mới, chỉ định chủ thể, bối cảnh, ánh sáng và khung hình. Với một chỉnh sửa, xác định ảnh nguồn, nêu thay đổi và chỉ ra các chi tiết phải giữ nguyên. Với một bố cục dùng nhiều tham chiếu, gán vai trò cho từng ảnh để nhận diện sản phẩm và phong cách thị giác không xung đột.
FLUX 3 Image Specifications and API Parameters
Lên kế hoạch cho ảnh của bạn với các thiết lập dưới đây. Các điều khiển model theo BFL FLUX 3 Image API reference; xác thực và định tuyến yêu cầu theo tích hợp CometAPI của bạn. Dùng tên trường được route FLUX 3 Image của CometAPI chấp nhận.
Capability / setting
What it controls
How to use it with CometAPI
Model identity
FLUX 3 Image; catalog ID flux-3-image
Sử dụng route theo model và quy ước định tuyến trong ví dụ tài khoản của bạn.
Generation / prompt
Cảnh, bố cục, hoặc hướng dẫn chỉnh sửa
Bắt đầu với một chủ thể rõ ràng và một đầu ra dự định.
Reference images / native images
Danh sách có thứ tự gồm 1–10 ảnh tham chiếu, cung cấp dạng URL HTTP(S) hoặc base64 trong native API.
Xác nhận tên trường, định dạng đầu vào và giới hạn tham chiếu của gateway.
Aspect ratio / native aspect_ratio
Tỷ lệ khung vẽ. Với auto, tỷ lệ yêu cầu trong prompt được ưu tiên; nếu không, các chỉnh sửa giữ khung hình của tham chiếu đầu tiên.
Chọn tỷ lệ cho định dạng bàn giao và xác nhận các giá trị được chấp nhận.
Resolution / native resolution
Tầng native: 768sq, 1k (mặc định), 1.5k, 2k và 4k. Kích thước chính xác phụ thuộc vào tỷ lệ khung.
Với chỉnh sửa, match_input giữ kích thước của tham chiếu đầu, giảm còn 4 MP nếu lớn hơn; một aspect_ratio rõ ràng sẽ chọn tầng gần nhất. width và height rõ ràng được ưu tiên.
Exact dimensions / width + height
Cung cấp cả hai số nguyên, mỗi số 256–6256 pixel. Chúng sẽ ghi đè resolution và aspect_ratio. Tổng diện tích bị giới hạn 16,822,272 pixel, hoặc 4,194,304 pixel khi dùng ảnh tham chiếu.
Dùng kích thước rõ ràng cho kích cỡ bàn giao cố định, như 1024 × 1280. Xác nhận route CometAPI của bạn chấp nhận các điều khiển native này.
Layout control
Hướng dẫn vị trí bằng hộp giới hạn (bounding-box)
Dùng cú pháp layout được tài liệu khi cần đặt vị trí chính xác.
Targeted edits
Thay đổi cho các chủ thể hoặc vùng chọn
So sánh vùng nguồn và kết quả ở các khu vực cần giữ nguyên.
Chọn kích thước theo một trong ba cách: một tầng resolution cộng aspect ratio, width cộng height cho khung vẽ chính xác, hoặc match_input cho một chỉnh sửa. Giữ bản gốc tham chiếu để so sánh khung và chi tiết sau khi sinh. Endpoint native sẽ từ chối các trường không hỗ trợ; dùng schema của route bạn đang gọi.
FLUX.2 vs FLUX 3 Image
Dimension
FLUX 2 MAX / FLUX 2 PRO
FLUX 3 Image
Practical assessment
Use case
Tạo ảnh từ văn bản/chỉnh sửa mạnh, biến thể theo họ
Dàn dựng ảnh chi tiết và chỉnh sửa bảo toàn điểm ảnh
So sánh cùng prompt thương hiệu
Resolution
Sinh ảnh độ phân giải cao tùy biến thể
2K/4K native rõ ràng
Kiểm tra chi tiết ở mức zoom 100%
Editing
Khả năng đa tham chiếu trong một số biến thể
Minh họa chỉnh sửa cục bộ
Đo độ lệch ở vùng không chỉnh sửa
Cost
Thay đổi theo biến thể và nền tảng
Giá CometAPI cho cấu hình đã chọn
So sánh theo mỗi ảnh được chấp nhận
CometAPI access
Có sẵn qua CometAPI dưới tên FLUX 2 PRO và FLUX 2 MAX
Có sẵn qua CometAPI dưới ID flux-3-image
Xác nhận yêu cầu riêng theo model trước khi đổi route sản xuất
Evaluation
Dùng đúng biến thể đang triển khai hiện tại
Chạy cùng prompt và bộ tham chiếu
So sánh đầu ra được chấp nhận và tổng chi phí quy trình
Giữ tích hợp FLUX.2 hiện tại làm đường cơ sở so sánh khi đánh giá FLUX 3 Image. Chạy cùng brief và tài sản tham chiếu qua cả hai quy trình, rồi so sánh số lượng đầu ra chấp nhận, thời gian thực hiện và tổng chi phí.
How Do You Generate an Image with FLUX 3 Image API in CometAPI?
POST https://api.cometapi.com/flux/v1/flux-3-image
Xác thực dùng Bearer token (kiểu CometAPI). Yêu cầu mặc định là bất đồng bộ.
3. Basic text-to-image example (cURL)
curl https://api.cometapi.com/flux/v1/flux-3-image \
-H "Authorization: Bearer $COMETAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Ultra-wide cinematic shot of a fog-drenched coastal highway at dawn, cliffs on one side, turquoise sea on the other, a single vintage car with headlights on, soft golden rim light",
"aspect_ratio": "21:9",
"resolution": "1k"
}'
Thăm dò cho đến khi status là "Ready". URL ảnh xuất hiện trong result.sample (tải xuống ngay; URL có chữ ký chỉ tạm thời).
Để chờ đồng bộ trong cùng yêu cầu, thêm "async": false vào body (giữ kết nối mở; đặt timeout phía client đủ rộng).
5. Python example (submit + poll)
import os
import time
import requests
API_KEY = os.environ["COMETAPI_KEY"]
BASE = "https://api.cometapi.com/flux/v1"
def generate_image(payload, name="flux3_image"):
# Submit
r = requests.post(
f"{BASE}/flux-3-image",
headers={
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
},
json=payload,
timeout=60,
)
r.raise_for_status()
task = r.json()
task_id = task["id"]
# Poll
while True:
time.sleep(1.5)
result = requests.get(
f"{BASE}/get_result",
params={"id": task_id},
headers={"Authorization": f"Bearer {API_KEY}"},
timeout=60,
).json()
status = result.get("status")
if status not in ("Pending", "Reasoning", "Generating"):
break
if status != "Ready":
raise RuntimeError(result)
# Download
img_url = result["result"]["sample"]
img = requests.get(img_url, timeout=120)
with open(f"{name}.png", "wb") as f:
f.write(img.content)
return f"{name}.png"
# Example call
generate_image({
"prompt": "A two-color risograph narrative illustration... a rabbit rides a pumpkin...",
"aspect_ratio": "16:9",
"resolution": "1k",
})
FLUX 3 Image hỗ trợ cả text-to-image thuần lẫn chỉnh sửa/đa tham chiếu trong cùng endpoint—chỉ cần thêm images và mô tả cách sử dụng chúng trong prompt (không có trường “mode” riêng).
Alternative: OpenAI-compatible route
Bạn cũng có thể thử endpoint images hợp nhất với model ID:
POST https://api.cometapi.com/v1/images/generations
(Ưu tiên native `/flux/v1/...` để có đầy đủ tham số FLUX 3.)
### Tips
* Kiểm tra tình trạng khả dụng và giá chính xác hiện tại trên trang model Flux 3 Image của [CometAPI](https://www.cometapi.com/models/flux/flux-3-image/).
* Luôn tải xuống URL `result.sample` nhanh chóng.
* Để có danh sách tham số mới nhất hoặc ví dụ playground, xem tài liệu Flux của CometAPI và tài liệu chính thức FLUX 3 Image của Black Forest Labs.
Cách này phản chiếu quy trình chính thức của BFL trong khi dùng xác thực và hạ tầng hợp nhất của CometAPI.
## How to Prompt FLUX 3 Image? Examples
### Example: Product Photography Prompt
Dùng prompt này cho bài thử sản phẩm đầu tiên.
A premium amber perfume bottle centered on matte limestone,
three-quarter product perspective, exact bottle silhouette,
softbox key light camera-left, detailed contact shadow,
subtle natural reflections, beige seamless studio backdrop,
no extra bottles, no watermark, no altered brand lettering.
Output: clean 4:5 e-commerce hero creative.
Thay thế giá trị prompt trong request.json bằng brief này, giữ nguyên body yêu cầu theo route CometAPI của bạn. Canvas 4:5 phù hợp bố cục dọc cho sản phẩm. Nếu route của bạn chấp nhận điều khiển kích thước native, 1024 × 1280 là tùy chọn 4:5 chính xác; cung cấp cả hai giá trị cùng nhau.
Bắt đầu với bản nháp nhỏ và kiểm tra đường viền chai, nhãn, phản xạ và vật thể dư. Nếu nhận diện sản phẩm là yếu tố quyết định, hãy dùng ảnh tham chiếu sản phẩm thay vì kỳ vọng prompt văn bản tái tạo chính xác.
### Example: Typography and Poster Layout
Prompt poster với tiêu đề được chỉ định rõ ràng.
An editorial art poster on warm off-white paper.
Title text exactly: THE SEED PARADE.
Three stylized walking seed characters below the title.
Two-color risograph-inspired printing, generous margins,
balanced hierarchy, crisp legible typography, portrait format.
Dùng brief này làm prompt trong yêu cầu CometAPI của bạn và chọn canvas dọc. Bắt đầu với bản nháp để kiểm tra vị trí tiêu đề và sắp xếp nhân vật, sau đó tăng kích thước đầu ra cho artwork cuối.
Xem độ chính xác chữ cái như một điều kiện chấp nhận đo lường được. Rà soát từng chữ cái và dấu câu ở độ phân giải cuối; hình ảnh ấn tượng không đảm bảo không có lỗi chữ cho văn bản thương hiệu của bạn.
## How to Edit Images with References
Với một chỉnh sửa, mô tả cả thay đổi mong muốn và các chi tiết cần giữ nguyên. Native FLUX 3 Image API nhận tham chiếu qua images; ánh xạ chúng sang trường đầu vào tương ứng trong ví dụ CometAPI của bạn. Đặt ảnh sản phẩm lên trước và giữ thứ tự đó nhất quán trong prompt.
### Single-Image Editing: Change the Background, Preserve the Product
Đặt edit.py cạnh submit.py, poll.py và download.py. Thiết lập PRODUCT\_IMAGE\_URL trỏ tới URL HTTPS công khai của ảnh sản phẩm, rồi chạy python edit.py. Ví dụ dưới đây yêu cầu route chấp nhận mảng images native. Dùng body yêu cầu chỉnh sửa không có trường ảnh nguồn xung đột, và thay đổi ánh xạ nếu ví dụ CometAPI của bạn dùng trường đầu vào khác. Để tiếp tục một tác vụ chỉnh sửa đã lưu, chạy python poll\_download.py editing-task.json.
import json
import os
from pathlib import Path
from submit import submit
from poll import wait_for_image
from download import download_image
This request variant requires a route accepting the native images array.
payload = json.loads(Path("request.json").read_text(encoding="utf-8"))
payload["images"] = [os.environ["PRODUCT_IMAGE_URL"]]
payload["prompt"] = (
"Use image 1 as the authoritative product reference. "
"Replace only the studio background with pale limestone and warm "
"morning window light. Preserve bottle shape, cap, label text, logo "
"position, and product color. Do not crop the product or add objects."
)
task_id = submit(payload, "editing-task.json")
image_url = wait_for_image(task_id)
print(download_image(image_url, "edited-product"))
Chọn ảnh sản phẩm sắc nét với nhãn đọc được và đường viền rõ. Gửi nó trong định dạng đầu vào ảnh được route CometAPI của bạn chấp nhận. Nếu route đó hỗ trợ thiết lập resolution native, hãy dùng match\_input để giữ khung và kích thước tham chiếu trong giới hạn chỉnh sửa của model.
[BFL gallery](https://bfl.ai/models/flux-3-image) minh họa một chỉnh sửa cục bộ bằng cách thêm hai thợ lặn. Các tài sản trước–sau chính thức này cho thấy những gì cần kiểm tra; chúng không phải là đầu ra từ yêu cầu CometAPI chạy cho bài viết này.
Ví dụ chỉnh sửa chính thức của BFL, trước: cảnh dưới nước gốc với một thợ lặn.
Ví dụ chỉnh sửa chính thức của BFL, sau: hai thợ lặn được thêm vào cảnh. Hãy kiểm tra cả nền không đổi lẫn các chủ thể mới.
### Multi-Image Reference Editing: Combine Style and Product Identity
Giữ ảnh sản phẩm trước và ảnh tham chiếu ánh sáng/phong cách thứ hai. Thiết lập PRODUCT\_IMAGE\_URL và STYLE\_IMAGE\_URL, lưu mã dưới đây thành multi\_edit.py cạnh ba file client, rồi chạy python multi\_edit.py. Ví dụ này yêu cầu route chấp nhận ít nhất hai tham chiếu trong images. Bắt đầu với body yêu cầu chỉnh sửa không có trường ảnh nguồn xung đột. Tiếp tục job đã lưu với python poll\_download.py multi-edit-task.json.
import json
import os
from pathlib import Path
from submit import submit
from poll import wait_for_image
from download import download_image
Preserve this order: product first, lighting/style second.
payload = json.loads(Path("request.json").read_text(encoding="utf-8"))
payload["images"] = [
os.environ["PRODUCT_IMAGE_URL"],
os.environ["STYLE_IMAGE_URL"],
]
payload["prompt"] = (
"Image 1 defines product identity. Image 2 defines lighting and color. "
"Create one promotional image with the exact product from image 1 "
"and the lighting mood of image 2. Preserve product lettering and "
"geometry. Do not copy logos, text, or extra objects from image 2."
)
task_id = submit(payload, "multi-edit-task.json")
print(download_image(wait_for_image(task_id), "multi-edited-product"))
Đính kèm cả hai tham chiếu theo định dạng riêng của CometAPI cho model. Trước hết, xem xét liệu sản phẩm có giữ được nhận diện; sau đó đánh giá liệu tham chiếu thứ hai mang lại ánh sáng và màu mong muốn. Nếu nó đưa vào vật thể hoặc chữ ngoài ý muốn, hãy đơn giản hóa tham chiếu đó hoặc viết prompt rõ ràng hơn.
## How to Use Bounding Boxes for Layout Control
Dùng hộp khi chai và tiêu đề cần chiếm các vùng dự đoán được. Viết chú thích cảnh với ID cho từng phần tử, rồi thêm một mảng JSON vào prompt. Định dạng của BFL dùng bbox theo thứ tự [top, left, bottom, right] trên lưới 0–1000; các hộp nằm trong prompt, không ở trường API riêng.
Ví dụ dưới đây chừa chỗ cho tiêu đề phía trên chai. Giữ thiết lập đầu ra dọc trong request.json và lưu file này là layout.py cạnh submit.py. Chạy python layout.py, sau đó python poll\_download.py layout-task.json. Dùng route hỗ trợ cú pháp layout này; kiểm tra kết quả để xem chai và tiêu đề có nằm trong vùng mong muốn không.
import json
from pathlib import Path
from submit import submit
caption = (
"A portrait perfume advertisement: an amber bottle <bottle_1> "
"below a headline <title_1>, on a warm beige background."
)
elements = [
{"id": "title_1", "bbox": [80, 120, 220, 880],
"desc": "Dark brown text reading AMBER, centered"},
{"id": "bottle_1", "bbox": [300, 300, 880, 700],
"desc": "One amber glass perfume bottle with a black cap"},
]
payload = json.loads(Path("request.json").read_text(encoding="utf-8"))
payload["prompt"] = caption + " " + json.dumps(elements)
print(submit(payload, "layout-task.json"))
Giữ tỷ lệ khung nhất quán với layout. Hộp hướng dẫn việc đặt vị trí hơn là cắt đối tượng theo biên cứng. Kiểm tra chính tả tiêu đề và khoảng cách trong ảnh đã lưu; thêm chữ thương hiệu cuối cùng trong công cụ thiết kế khi cần typography chính xác.
## How Much Does FLUX 3 Image API Cost?
CometAPI cung cấp FLUX 3 Image từ [$0.0384 mỗi yêu cầu](https://www.cometapi.com/models/flux/flux-3-image/) (November 9, 2026). Dùng mức khởi điểm này cho ngân sách ban đầu, rồi áp dụng mức giá hiển thị cho cấu hình bạn đã chọn. Ví dụ dưới đây giả định mọi yêu cầu tính phí đều dùng mức khởi điểm.
| Billed requests | Assumed rate / request | Illustrative cost |
| --------------- | ---------------------- | ----------------- |
| 1 | $0.0384 | $0.0384 |
| 10 | $0.0384 | $0.3840 |
| 100 | $0.0384 | $3.84 |
| 1000 | $0.0384 | $38.40 |
Kiểm tra mức giá cho cấu hình và tài khoản đã chọn trước khi chạy hàng loạt. Giá khởi điểm công khai không xác lập giá cho mọi tùy chọn độ phân giải hoặc chỉnh sửa. Theo dõi cả các nỗ lực sáng tạo bị từ chối cũng như đầu ra được duyệt: nếu bạn chi $3.84 cho 100 yêu cầu bị tính phí và duyệt 80 sản phẩm, chi phí API trên mỗi sản phẩm được chấp nhận là $0.048, chưa tính duyệt thủ công và lưu trữ. Đây là phép tính minh họa, không phải tỷ lệ chấp nhận đo lường.
### Resolution Choices by Workflow
| Workflow | First test | Approval check |
| ----------------------------- | ------------------------------------------------ | ------------------------------------------------- |
| Prompt exploration | Tầng nhỏ nhất hữu dụng được hỗ trợ | Bố cục và vị trí chủ thể |
| E-commerce product images | Bản nháp với khung cắt dự định | Hình học sản phẩm, nhãn và chi tiết viền |
| Campaign or editorial artwork | Nháp trước; tăng kích thước sau khi duyệt layout | Typography và chi tiết ở kích thước bàn giao |
| Reference-based edits | Thiết lập được hỗ trợ phù hợp với nguồn | Vùng không đổi, nhận diện sản phẩm và ánh sáng |
## When Should You Use FLUX 3 Video Instead?
Dùng FLUX 3 Image cho tài sản tĩnh như ảnh hero sản phẩm, poster hoặc khung chiến dịch. Nếu đầu ra cần chuyển động, xem [FLUX 3 Video trên CometAPI](https://www.cometapi.com/models/flux-3/), dưới ID model riêng flux-3. Quy trình [video](https://apidoc.cometapi.com/api/video/flux-3/create) dùng thiết lập và tính phí dành cho video. Giữ yêu cầu ảnh và video tách biệt; thời lượng, âm thanh và điều khiển khung hình video không thuộc yêu cầu ảnh tĩnh.
Với chiến dịch có cả hai định dạng, hãy duyệt bố cục ảnh tĩnh trước, rồi chuẩn bị brief chuyển động riêng. Kiểm tra yêu cầu đầu vào tham chiếu của model video trước khi tái dùng ảnh đã duyệt làm nguồn.
## Conclusion
Bắt đầu với một brief sản phẩm và một job ảnh nhỏ. Gửi qua route FLUX 3 Image của CometAPI, lưu task ID, truy xuất ảnh hoàn tất và duyệt kết quả trước khi mở rộng. Dùng width và height khi cần khung vẽ chính xác, hoặc match\_input cho chỉnh sửa dựa trên tham chiếu nếu được hỗ trợ. So sánh tổng chi tiêu với số ảnh bạn duyệt để ngân sách phản ánh kết quả có thể sử dụng.
## SEO Metadata
Meta title: Hướng dẫn FLUX 3 Image API: Tạo ảnh, Chỉnh sửa & CometAPI
Meta description: Sử dụng FLUX 3 Image trên CometAPI để tạo và chỉnh sửa. Tìm hiểu tham số ảnh, xử lý job bất đồng bộ, ví dụ prompt và giá từ $0.0384 mỗi yêu cầu.
Keywords: FLUX 3 Image API, CometAPI FLUX 3 Image, chỉnh sửa ảnh FLUX 3, giá FLUX 3, tạo ảnh tham chiếu, chuyển đổi từ FLUX.2
URL slug: flux-3-image-api-guide
Authentication
Khóa API CometAPI cho các yêu cầu qua gateway
Tuân theo header xác thực trong ví dụ CometAPI; giữ khóa trên máy chủ.
Result handling
Sinh ảnh bất đồng bộ: gửi job, theo dõi task ID và truy xuất ảnh hoàn tất.
Dùng mẫu Python bên dưới khi route tài khoản của bạn tuân theo task contract FLUX của CometAPI được ghi tài liệu.
Pricing
Giá CometAPI bắt đầu từ $0.0384 mỗi yêu cầu (November 9, 2026).
Dùng phần giá dưới đây cho ngân sách minh họa; xác minh cấu hình đã chọn.
Extra fields
Schema native và gateway khác nhau giữa các thế hệ model
Native FLUX 3 Image chấp nhận width và height. Không tái sử dụng seed hoặc input_image từ model cũ; dùng images cho đầu vào tham chiếu native và tuân theo schema gateway của CometAPI.
