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. Назва заголовка така сама, як для ключів організації; особисті ключі використовують ту саму кінцеву точку.

Вхідні файли:Викличте 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}

Опитуйте з тим самим ключем 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.