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

Model lisansları

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.

Birlikte verilen lisans

Bildirim

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.

Birlikte verilen lisans

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.

Birlikte verilen lisans

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.

Birlikte verilen lisans

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.

Birlikte verilen lisans

ÜcretsizÇevrimiçiSınırsızIDOL API erişimi

API başvurusu

REST ile gönderin

Kendi araçlarınızdan bu iş yükü için iş oluşturmak üzere kişisel API anahtarınızı (msk_…) kullanın. Bu şekilde başlatılan işler, Cihazlarınız sayfasında bağladığınız aynı cihazlarda çalışır — en az birinin çevrimiçi olması gerekir.

API ayrıntılarını gizle
POSThttps://cp.meshlabs.cloud/v1/organizations/jobs

X-Organization-Api-Key: msk_your_personal_api_key ile kimlik doğrulayın. Başlık adı kuruluş anahtarlarıyla aynıdır; kişisel anahtarlar da aynı uç noktayı kullanır.

Girdi dosyaları:Aynı API anahtarıyla POST https://cp.meshlabs.cloud/v1/organizations/job-inputs/presign çağrısı yapın, dosyanızı döndürülen upload_url adresine yükleyin, ardından download_url değerini job_spec içinde iletin (örneğin input_image_url olarak).

İstek gövdesi

{
  "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 alanları

AlanZorunluVarsayılanAçıklama
input_image_urlEvet—The picture: an object on a transparent background (a PNG with its alpha).
modeEvet—Whether the picture is a synthetic render or a real photograph. It sets the crop margin.
crop_marginHayır—The crop around the object. Defaults to 1.2 for synthetic and 1.7 for real.
stepsHayır50Denoising steps.
cfg_strengthHayır3Guidance against an empty condition. 0 turns it off and halves the work.
rescale_tHayır3How far the time grid is shifted towards noise.
num_gaussiansHayır1048576Gaussians in the splat, a multiple of 32.
seedHayır0Random 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}

status son duruma (COMPLETED, FAILED, CANCELED veya MODERATION_BLOCKED) ulaşana kadar aynı API anahtarıyla yoklayın. İçerik denetimi etkin olduğunda işler, hesaplama kuyruğuna girmeden önce MODERATION_PENDING durumunda başlayabilir. Tamamlanan işler her çıktıda önceden imzalanmış download_url değerleri içerir.

Oluşturma yanıtı

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

Tamamlanma yanıtı

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