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_…) για να δημιουργείτε εργασίες για αυτόν τον φόρτο εργασίας από τα δικά σας εργαλεία. Οι εργασίες που ξεκινούν με αυτόν τον τρόπο εκτελούνται στις ίδιες συσκευές που συνδέσατε στη σελίδα Οι συσκευές σας — τουλάχιστον μία πρέπει να είναι online.
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}Κάντε poll με το ίδιο κλειδί 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.