Ả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.

Giấy phép đi kèm

Thông báo

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.

Giấy phép đi kèm

Thông báo

Qwen3-4B text encoder distributed by FLUX.2 klein · Apache-2.0

Miễn phíTrực tuyếnKhông giới hạnFLUX.2 klein by Black Forest Labs Truy cập API

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.

Ẩn chi tiết API
POSThttps://cp.meshlabs.cloud/v1/organizations/jobs

Xá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.

Tệp đầu vào:Gọi 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ườngBắt buộcMặc địnhMô tả
promptCó—Mô tả bằng văn bản để tạo ảnh
input_image_urlKhô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.
widthKhông512Chiều rộng ảnh đầu ra tính bằng điểm ảnh
heightKhông512Chiều cao ảnh đầu ra tính bằng điểm ảnh
seedKhông—Seed ngẫu nhiên để có thể tái lập kết quả
strengthKhông0.8Tỷ 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.
numStepsKhông4Số bước khử nhiễu (mặc định của FLUX.2-klein: 4)
num_stepsKhông—Snake-case alias of numSteps. Omit it and numSteps is what runs.
compression_methodKhôngfp16Bộ 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_thresholdKhông0.05Ngâ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_blockKhông128Kí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
  }
}'
GEThttps://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.