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

Giấy phép mô hình

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.

Giấy phép đi kèm

Thông báo

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.

Giấy phép đi kèm

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.

Giấy phép đi kèm

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.

Giấy phép đi kèm

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.

Giấy phép đi kèm

Miễn phíTrực tuyếnKhông giới hạnIDOL Truy cập API

Tài liệu tham khảo API

Gửi qua REST

Dùng khóa API cá nhân của bạn (msk_…) để tạo tác vụ cho workload này từ công cụ của riêng bạn. Tác vụ khởi chạy theo cách này chạy trên chính các thiết bị bạn đã kết nối tại Thiết bị của bạn — ít nhất một thiết bị phải trực tuyến.

Ẩn chi tiết API
POSThttps://cp.meshlabs.cloud/v1/organizations/jobs

Xác thực bằng X-Organization-Api-Key: msk_your_personal_api_key. Tên header giống với khóa tổ chức; khóa cá nhân dùng cùng endpoint.

Tệp đầu vào:Gọi POST https://cp.meshlabs.cloud/v1/organizations/job-inputs/presign với cùng khóa API, tải tệp của bạn lên upload_url được trả về, rồi truyền download_url trong job_spec (ví dụ dưới dạng input_image_url).

Nội dung yêu cầu

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

Các trường của job_spec

TrườngBắt buộcMặc địnhMô tả
input_image_urlCó—The picture: an object on a transparent background (a PNG with its alpha).
modeCó—Whether the picture is a synthetic render or a real photograph. It sets the crop margin.
crop_marginKhông—The crop around the object. Defaults to 1.2 for synthetic and 1.7 for real.
stepsKhông50Denoising steps.
cfg_strengthKhông3Guidance against an empty condition. 0 turns it off and halves the work.
rescale_tKhông3How far the time grid is shifted towards noise.
num_gaussiansKhông1048576Gaussians in the splat, a multiple of 32.
seedKhông0Random 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}

Thăm dò bằng cùng khóa API cho đến khi status ở trạng thái kết thúc (COMPLETED, FAILED, CANCELED hoặc MODERATION_BLOCKED). Khi kiểm duyệt nội dung được bật, tác vụ có thể bắt đầu ở MODERATION_PENDING trước khi vào hàng đợi tính toán. Tác vụ đã hoàn tất có các giá trị download_url được ký trước trên mỗi đầu ra.

Phản hồi khi tạo

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

Phản hồi khi hoàn tấ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.