圖片
Bonsai 圖像產生器
輸入提示詞即可取得 PNG,在您連接的裝置上使用精簡的 1 位元 Bonsai Image 文字生圖。
Bonsai Image by Prism ML; FLUX.2 klein by Black Forest Labs; Qwen3 by Alibaba Cloud
模型授權
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
API 參考
透過 REST 提交
使用您的個人 API 金鑰(msk_…),從您自己的工具為此工作負載建立工作。以這種方式啟動的工作,會在您於 您的裝置 連接的同一批裝置上執行——至少須有一部在線上。
https://cp.meshlabs.cloud/v1/organizations/jobs使用 X-Organization-Api-Key: msk_your_personal_api_key 進行驗證。此標頭名稱與組織金鑰相同;個人金鑰使用同一個端點。
POST https://cp.meshlabs.cloud/v1/organizations/job-inputs/presign,將您的檔案上傳到傳回的 upload_url,然後在 job_spec 中傳入 download_url(例如作為 input_image_url)。請求內文
{
"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"
}
}job_spec 欄位
| 欄位 | 必填 | 預設值 | 說明 |
|---|---|---|---|
prompt | 是 | — | 圖片的文字描述。 |
input_image_url | 否 | — | 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 | 否 | 1024 | 輸出寬度(像素,需為 16 的倍數)。 |
height | 否 | 1024 | 輸出高度(像素,需為 16 的倍數)。 |
strength | 否 | 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 | 否 | 4 | 去噪步數(Bonsai Image 已蒸餾為 4 步)。 |
seed | 否 | — | 可重現生成結果的隨機種子。 |
shift | 否 | 3 | 流匹配排程偏移。此模型設計值為 3.0。 |
compression_method | 否 | fp16 | 用於節點間 FP32 DiT 啟動值交接的編解碼器。 |
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}使用同一個 API 金鑰輪詢,直到 status 進入終止狀態(COMPLETED、FAILED、CANCELED 或 MODERATION_BLOCKED)。啟用內容審核時,工作可能會先處於 MODERATION_PENDING 狀態,之後才進入運算佇列。已完成的工作會在每個輸出上附帶預先簽署的 download_url 值。
建立回應
{
"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"
}完成回應
{
"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>"
}輸入文字提示詞並下載產生的 PNG。Bonsai Image 是免費的線上文字生圖工具:這是精簡的 1 位元 FLUX.2 Klein 4B 模型,只需四個步驟就能將自然語言描述變成圖片,並在您連接到 MESH 的電腦上無限制執行。原生尺寸為 1024×1024;512×512 則是更快的預覽。不需要負面提示詞。