Ảnh
Trình tạo ảnh Bonsai
Nhập mô tả và nhận ảnh PNG — mô hình chuyển văn bản thành ảnh Bonsai Image 1-bit gọn nhẹ trên các thiết bị bạn kết nối.
Bonsai Image by Prism ML; FLUX.2 klein by Black Forest Labs; Qwen3 by Alibaba Cloud
Giấy phép mô hình
Prism ML Bonsai Image binary DiT · Apache-2.0
Retain complete Apache-2.0 licence, upstream copyright and NOTICE texts; prominently identify modified files. Patent termination and trademark limitations apply. Prism ML requests public attribution, preserved here and in the catalog.
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": "bonsai-image-binary-4b",
"job_spec": {
"prompt": "A photorealistic lighthouse at dusk",
"width": 1024,
"height": 1024,
"strength": 0.8,
"steps": 4,
"shift": 3,
"compression_method": "fp16"
}
}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 của bức ảnh. |
input_image_url | Không | — | Optional input image for image editing (img2img). When set, the image is VAE-encoded and mixed with noise by 'strength'; the prompt describes the desired edit. |
width | Không | 1024 | Chiều rộng ảnh đầu ra tính bằng điểm ảnh (bội số của 16). |
height | Không | 1024 | Chiều cao ảnh đầu ra tính bằng điểm ảnh (bội số của 16). |
strength | Không | 0.8 | img2img noise fraction: 0.3 = light touch-up, 0.8 = heavy edit, 1.0 = ignore the input image. Only used with input_image_url. |
steps | Không | 4 | Số bước khử nhiễu (Bonsai Image được chưng cất xuống 4 bước). |
seed | Không | — | Seed ngẫu nhiên để tạo ảnh có thể tái lập. |
shift | Không | 3 | Độ dịch lịch trình flow-match. Mô hình được thiết kế cho giá trị 3.0. |
compression_method | Không | fp16 | Bộ mã hóa/giải mã cho việc chuyển giao kích hoạt DiT FP32 giữa các node. |
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": "bonsai-image-binary-4b",
"job_spec": {
"prompt": "A photorealistic lighthouse at dusk",
"width": 1024,
"height": 1024,
"strength": 0.8,
"steps": 4,
"shift": 3,
"compression_method": "fp16"
}
}'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": "bonsai-image-binary-4b",
"status": "PENDING",
"job_spec_json": {
"prompt": "A photorealistic lighthouse at dusk",
"width": 1024,
"height": 1024,
"strength": 0.8,
"steps": 4,
"shift": 3,
"compression_method": "fp16"
},
"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": "bonsai-image-binary-4b",
"status": "COMPLETED",
"job_spec_json": {
"prompt": "A photorealistic lighthouse at dusk",
"width": 1024,
"height": 1024,
"strength": 0.8,
"steps": 4,
"shift": 3,
"compression_method": "fp16"
},
"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ả bằng văn bản và tải về ảnh PNG được tạo ra. Bonsai Image là công cụ tạo ảnh từ văn bản trực tuyến miễn phí: một mô hình FLUX.2 Klein 4B 1-bit gọn nhẹ biến các mô tả bằng ngôn ngữ tự nhiên thành hình ảnh chỉ trong bốn bước, chạy không giới hạn trên các máy tính bạn kết nối với MESH. Kích thước gốc là 1024×1024; 512×512 là bản xem trước nhanh hơn. Không cần mô tả phủ định.