3D
IDOL Image to 3D Splat
IDOL: one picture of an object to a 3D Gaussian splat PLY.
Built with DINOv3.
Copyright (c) 2026 VAST
ใบอนุญาตโมเดล
IDOL · Apache-2.0
Apache License 2.0. Keep the licence text with the weights. Card declares apache-2.0; the repo publishes no LICENSE file, so the standard text is shipped.
DINOv3 ViT-H+/16 · LicenseRef-DINOv3-License
Redistribution under the DINOv3 License with a copy of it; use must comply with trade-control law (no ITAR, military, nuclear or weapons end uses); no reverse engineering. Research publications must acknowledge DINO Materials. The text sets no commercial-use limit and no Built-with label; the label is Mesh's choice.
BiRefNet · MIT
MIT, Copyright (c) 2024 ZhengPeng. Keep the copyright and permission notice. The HF repo has no LICENSE file; the text is from the GitHub repo.
FLUX.2-klein-4B VAE encoder · Apache-2.0
Apache License 2.0. Keep the licence text with the weights. Only the encoder is kept.
TripoSplat (probable IDOL denoiser ancestor) · MIT
Conservative notice preservation for probable lineage, not a claim of checkpoint identity. Keep VAST copyright and MIT permission notice.
เอกสารอ้างอิง 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 ด้วยคีย์ API เดียวกัน อัปโหลดไฟล์ของคุณไปยัง upload_url ที่ได้รับ จากนั้นส่ง download_url ใน job_spec (เช่น เป็น input_image_url)เนื้อหาคำขอ
{
"workload_type": "idol-i2gs",
"job_spec": {
"input_image_url": "https://…/your-input.png",
"mode": "synthetic",
"steps": 50,
"cfg_strength": 3,
"rescale_t": 3,
"num_gaussians": 1048576,
"seed": 0
}
}ฟิลด์ของ job_spec
| ฟิลด์ | จำเป็น | ค่าเริ่มต้น | คำอธิบาย |
|---|---|---|---|
input_image_url | ใช่ | — | The picture: an object on a transparent background (a PNG with its alpha). |
mode | ใช่ | — | Whether the picture is a synthetic render or a real photograph. It sets the crop margin. |
crop_margin | ไม่ | — | The crop around the object. Defaults to 1.2 for synthetic and 1.7 for real. |
steps | ไม่ | 50 | Denoising steps. |
cfg_strength | ไม่ | 3 | Guidance against an empty condition. 0 turns it off and halves the work. |
rescale_t | ไม่ | 3 | How far the time grid is shifted towards noise. |
num_gaussians | ไม่ | 1048576 | Gaussians in the splat, a multiple of 32. |
seed | ไม่ | 0 | Random seed. No seed is seed 0. |
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": "idol-i2gs",
"job_spec": {
"input_image_url": "https://…/your-input.png",
"mode": "synthetic",
"steps": 50,
"cfg_strength": 3,
"rescale_t": 3,
"num_gaussians": 1048576,
"seed": 0
}
}'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": "idol-i2gs",
"status": "PENDING",
"job_spec_json": {
"input_image_url": "https://…/your-input.png",
"mode": "synthetic",
"steps": 50,
"cfg_strength": 3,
"rescale_t": 3,
"num_gaussians": 1048576,
"seed": 0
},
"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": "idol-i2gs",
"status": "COMPLETED",
"job_spec_json": {
"input_image_url": "https://…/your-input.png",
"mode": "synthetic",
"steps": 50,
"cfg_strength": 3,
"rescale_t": 3,
"num_gaussians": 1048576,
"seed": 0
},
"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>"
}Upload one picture of an object on a transparent background and download a 3D Gaussian splat as a PLY file. IDOL runs 50 denoising steps and up to 1,048,576 Gaussians.