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.

वितरित लाइसेंस

मुफ़्तऑनलाइनअसीमितIDOL API पहुँच

API संदर्भ

REST से सबमिट करें

अपने टूल से इस वर्कलोड के लिए जॉब बनाने हेतु अपनी व्यक्तिगत API कुंजी (msk_…) का उपयोग करें। इस तरह शुरू किए गए जॉब उन्हीं डिवाइस पर चलते हैं जिन्हें आपने आपके डिवाइस पर कनेक्ट किया है — कम से कम एक का ऑनलाइन होना ज़रूरी है।

API विवरण छिपाएँ
POSThttps://cp.meshlabs.cloud/v1/organizations/jobs

X-Organization-Api-Key: msk_your_personal_api_key से प्रमाणित करें। हेडर का नाम ऑर्ग कुंजियों जैसा ही है; व्यक्तिगत कुंजियाँ उसी एंडपॉइंट का उपयोग करती हैं।

इनपुट फ़ाइलें:उसी API कुंजी से POST https://cp.meshlabs.cloud/v1/organizations/job-inputs/presign को कॉल करें, लौटाए गए 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नहीं50Denoising steps.
cfg_strengthनहीं3Guidance against an empty condition. 0 turns it off and halves the work.
rescale_tनहीं3How far the time grid is shifted towards noise.
num_gaussiansनहीं1048576Gaussians in the splat, a multiple of 32.
seedनहीं0Random 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
  }
}'
GEThttps://cp.meshlabs.cloud/v1/organizations/jobs/{job_id}

उसी API कुंजी से तब तक पोल करें जब तक status अंतिम स्थिति (COMPLETED, FAILED, CANCELED या MODERATION_BLOCKED) में न पहुँच जाए। जब सामग्री मॉडरेशन सक्षम होता है, तो कंप्यूट कतार में जाने से पहले जॉब MODERATION_PENDING में शुरू हो सकते हैं। पूरे हुए जॉब में हर आउटपुट पर presigned download_url मान होते हैं।

Create प्रतिक्रिया

{
  "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"
}

Completed प्रतिक्रिया

{
  "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.