Ảnh
Tạo ảnh FLUX.2
Nhập mô tả và tải về một bức ảnh. Chuyển văn bản thành ảnh miễn phí trên các thiết bị bạn kết nối.
Trình tạo ảnh FLUX.2
FLUX.2 klein by Black Forest Labs
FLUX.2 klein by Black Forest Labs; Qwen3 by Alibaba Cloud
Giấy phép mô hình
FLUX.2 klein 4B fifteen-stage transformer · Apache-2.0
Retain full Apache-2.0 terms and copyright notices, mark modifications; patent termination and trademark limitations apply.
FLUX.2 klein VAE and shared pipeline/tokenizer derivatives · Apache-2.0
Retain complete Apache-2.0 licence, upstream copyright and NOTICE texts; prominently identify modified files. Patent termination and trademark limitations apply.
Qwen3-4B text encoder distributed by FLUX.2 klein · Apache-2.0
Tài liệu tham khảo API
Gửi qua REST
Dùng khóa API cá nhân của bạn (msk_…) để tạo tác vụ cho workload này từ công cụ của riêng bạn. Tác vụ khởi chạy theo cách này chạy trên chính các thiết bị bạn đã kết nối tại Thiết bị của bạn — ít nhất một thiết bị phải trực tuyến.
https://cp.meshlabs.cloud/v1/organizations/jobsXác thực bằng X-Organization-Api-Key: msk_your_personal_api_key. Tên header giống với khóa tổ chức; khóa cá nhân dùng cùng endpoint.
POST https://cp.meshlabs.cloud/v1/organizations/job-inputs/presign với cùng khóa API, tải tệp của bạn lên upload_url được trả về, rồi truyền download_url trong job_spec (ví dụ dưới dạng input_image_url).Nội dung yêu cầu
{
"workload_type": "flux-2-klein-4b-t2i",
"job_spec": {
"prompt": "A photorealistic lighthouse at dusk",
"width": 512,
"height": 512,
"strength": 0.8,
"numSteps": 4,
"compression_method": "fp16",
"compression_error_threshold": 0.05,
"compression_hq8_block": 128
}
}Các trường của job_spec
| Trường | Bắt buộc | Mặc định | Mô tả |
|---|---|---|---|
prompt | Có | — | Mô tả bằng văn bản để tạo ảnh |
input_image_url | Không | — | Ảnh đầu vào tùy chọn để chỉnh sửa ảnh (img2img). Khi được đặt, ảnh được mã hóa VAE và trộn với nhiễu theo 'strength'; mô tả nêu chỉnh sửa mong muốn. |
width | Không | 512 | Chiều rộng ảnh đầu ra tính bằng điểm ảnh |
height | Không | 512 | Chiều cao ảnh đầu ra tính bằng điểm ảnh |
seed | Không | — | Seed ngẫu nhiên để có thể tái lập kết quả |
strength | Không | 0.8 | Tỷ lệ nhiễu img2img: 0.3 = chỉnh nhẹ, 0.8 = chỉnh mạnh, 1.0 = bỏ qua ảnh đầu vào. Chỉ dùng cùng input_image_url. |
numSteps | Không | 4 | Số bước khử nhiễu (mặc định của FLUX.2-klein: 4) |
num_steps | Không | — | Snake-case alias of numSteps. Omit it and numSteps is what runs. |
compression_method | Không | fp16 | Bộ mã hóa/giải mã cho việc chuyển giao kích hoạt giữa các shard DiT. 'off' gửi Float32 thô. hq8/hq4 = lượng tử hóa Hadamard; stp = hạng thấp; fp16 = nửa độ chính xác; auto8 = bộ định tuyến chọn phương án tốt nhất. Được báo cáo qua các chỉ số tác vụ codec_ms / transport_savings_pct. |
compression_error_threshold | Không | 0.05 | Ngân sách sai số Frobenius tương đối cho các bộ mã hóa/giải mã có tổn hao (0.01 nghiêm ngặt … 0.05 thoải mái). |
compression_hq8_block | Không | 128 | Kích thước khối Hadamard/lượng tử hóa cho HQ8/HQ4 (lũy thừa của 2). Nhỏ hơn = sai số thấp hơn. |
cURL
curl -X POST https://cp.meshlabs.cloud/v1/organizations/jobs \
-H "X-Organization-Api-Key: msk_your_personal_api_key" \
-H "Content-Type: application/json" \
-d '{
"workload_type": "flux-2-klein-4b-t2i",
"job_spec": {
"prompt": "A photorealistic lighthouse at dusk",
"width": 512,
"height": 512,
"strength": 0.8,
"numSteps": 4,
"compression_method": "fp16",
"compression_error_threshold": 0.05,
"compression_hq8_block": 128
}
}'https://cp.meshlabs.cloud/v1/organizations/jobs/{job_id}Thăm dò bằng cùng khóa API cho đến khi status ở trạng thái kết thúc (COMPLETED, FAILED, CANCELED hoặc MODERATION_BLOCKED). Khi kiểm duyệt nội dung được bật, tác vụ có thể bắt đầu ở MODERATION_PENDING trước khi vào hàng đợi tính toán. Tác vụ đã hoàn tất có các giá trị download_url được ký trước trên mỗi đầu ra.
Phản hồi khi tạo
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"workload_type": "flux-2-klein-4b-t2i",
"status": "PENDING",
"job_spec_json": {
"prompt": "A photorealistic lighthouse at dusk",
"width": 512,
"height": 512,
"strength": 0.8,
"numSteps": 4,
"compression_method": "fp16",
"compression_error_threshold": 0.05,
"compression_hq8_block": 128
},
"work_units": [],
"outputs": [],
"created_at": "2026-06-08T12:00:00Z",
"updated_at": "2026-06-08T12:00:00Z"
}Phản hồi khi hoàn tất
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"workload_type": "flux-2-klein-4b-t2i",
"status": "COMPLETED",
"job_spec_json": {
"prompt": "A photorealistic lighthouse at dusk",
"width": 512,
"height": 512,
"strength": 0.8,
"numSteps": 4,
"compression_method": "fp16",
"compression_error_threshold": 0.05,
"compression_hq8_block": 128
},
"work_units": [
{
"id": "…",
"index": 0,
"status": "COMPLETED"
}
],
"outputs": [
{
"id": "…",
"output_type": "<output type>",
"filename": "<output filename>",
"size_bytes": 524288,
"download_url": "<presigned output download URL>"
}
],
"created_at": "2026-06-08T12:00:00Z",
"updated_at": "<completion timestamp>"
}Nhập mô tả và tải về một bức ảnh. FLUX.2 Klein là mô hình chuyển văn bản thành ảnh trực tuyến miễn phí trên các thiết bị bạn kết nối. Lần chạy đầu tiên sẽ tải mô hình về; các ảnh sau sẽ bắt đầu nhanh hơn. Đây là công cụ tạo ảnh từ mô tả trống, không phải trình chỉnh sửa theo chỉ dẫn.