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.

Συνοδευτική άδεια

ΔωρεάνOnlineΧωρίς όριαIDOL Πρόσβαση API

Αναφορά API

Υποβολή μέσω REST

Χρησιμοποιήστε το προσωπικό σας κλειδί API (msk_…) για να δημιουργείτε εργασίες για αυτόν τον φόρτο εργασίας από τα δικά σας εργαλεία. Οι εργασίες που ξεκινούν με αυτόν τον τρόπο εκτελούνται στις ίδιες συσκευές που συνδέσατε στη σελίδα Οι συσκευές σας — τουλάχιστον μία πρέπει να είναι online.

Απόκρυψη λεπτομερειών API
POSThttps://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Όχι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}

Κάντε 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.