3D

TripoSG 이미지-3D 변환

사진 한 장을 휴대폰에서도 다운로드할 수 있는 3D 메시로 만들어 보세요.

TripoSG by VAST-AI-Research; DINOv2 by Meta AI; U2-Net by Xuebin Qin and contributors; rembg by Daniel Gatis

Real-ESRGAN by Xintao Wang

4x-UltraSharp by Kim2091, CC BY-NC-SA 4.0; converted to ONNX by Mesh, unchanged learned tensors.

모델 라이선스

TripoSG DiT and VAE ONNX derivatives · MIT

Preserve the complete MIT terms, copyright notice and disclaimer, and identify modifications. No upstream endorsement is granted.

포함된 라이선스

고지

DINOv2 Large conditioning image encoder · Apache-2.0

Preserve the complete Apache-2.0 terms, copyright notices and disclaimers, identify modifications, and respect Apache patent/trademark provisions. No upstream endorsement is granted.

U2-Net matte, rembg ONNX release · Apache-2.0 AND MIT

Preserve the complete applicable MIT/Apache-2.0 terms, copyright notices and disclaimers, identify modifications, and respect Apache patent/trademark provisions. No upstream endorsement is granted.

Real-ESRGAN x4plus original release ONNX derivative · BSD-3-Clause

Retain the original copyright notice, all three BSD conditions and warranty disclaimer with distributed copies. No endorsement using author/contributor names without permission.

포함된 라이선스

고지

Original 4x-UltraSharp ONNX conversion by Mesh · CC-BY-NC-SA-4.0

NonCommercial only. Preserve attribution, full license and modification notice. ShareAlike applies to adapted licensed material. Private compute only, unmetered, requester and operator acceptance required; no global-network execution. Acceptance does not grant commercial permission.

포함된 라이선스

고지

무료온라인무제한UltraSharp API 액세스

API 레퍼런스

REST로 제출

개인 API 키(msk_…)를 사용하여 내 도구에서 이 워크로드의 작업을 생성하세요. 이렇게 시작한 작업은 내 기기에서 연결한 기기와 동일한 기기에서 실행되며, 최소 한 대는 온라인이어야 합니다.

API 세부 정보 숨기기
POSThttps://cp.meshlabs.cloud/v1/organizations/jobs

X-Organization-Api-Key: msk_your_personal_api_key로 인증합니다. 헤더 이름은 조직 키와 같으며, 개인 키도 같은 엔드포인트를 사용합니다.

입력 파일:같은 API 키로 POST https://cp.meshlabs.cloud/v1/organizations/job-inputs/presign을(를) 호출하고, 반환된 upload_url에 파일을 업로드한 다음, job_spec에 download_url을(를) 전달하세요(예: input_image_url로).

요청 본문

{
  "workload_type": "triposg-1-5b-i2m",
  "job_spec": {
    "input_image_url": "https://…/your-input.png",
    "remove_background": true,
    "steps": 50,
    "guidance_scale": 7,
    "grid_resolution": 192,
    "texture": true,
    "texture_upscale": false,
    "texture_upscaler": "ultrasharp"
  }
}

job_spec 필드

필드필수기본값설명
input_image_url예—물체 하나가 담긴 사진 또는 렌더링입니다. 피사체는 자동으로 오려낸 뒤 정사각형으로 크롭하고 224x224로 크기를 조정하므로, 뚜렷한 피사체 하나일 때 형상이 가장 좋습니다. 복잡한 장면이나 여러 물체는 오려내기를 혼란스럽게 합니다. 이미 투명 배경이 있는 PNG는 오려내기 단계를 건너뛰며 가장 신뢰할 수 있는 입력입니다.
remove_background아니요true이미지에 자체 투명 영역이 없을 때 세그멘테이션 모델을 실행합니다. 이미 흰 배경에 깔끔하게 오려낸 이미지이거나 피사체가 프레임을 가득 채울 때는 끄세요.
steps아니요50Rectified-flow 단계 수입니다. 약 16 미만에서는 형태는 알아볼 수 있지만 미세한 굴곡이 사라지고, 기본값을 넘으면 더 이상 달라지지 않습니다.
guidance_scale아니요7메시가 참조 이미지를 얼마나 충실히 따를지 정합니다.
seed아니요—재현 가능한 생성을 위한 랜덤 시드입니다.
grid_resolution아니요192표면을 추출하는 필드의 해상도입니다. 비용은 세제곱에 비례해 증가합니다. 256은 기본값의 약 2.4배의 작업량이지만, 그 차이는 대부분 스무딩을 거치면 남지 않습니다.
texture아니요true사진을 메시에 기본 색상 텍스처로 투영합니다. 사진에 보이는 면은 선명하게 나오고, 반대편은 한 장의 이미지로는 볼 수 없으므로 가장 가까운 실루엣 색상이 번진 모양이 됩니다. 단색 회색 메시를 원하면 끄세요. 파일이 더 작아지며 직접 텍스처를 입힐 계획이라면 알맞은 선택입니다.
texture_upscale아니요false투영하기 전에 피사체에 4배 초해상도 패스를 실행합니다. 피사체가 프레임에서 작을 때만 가치가 있습니다. 텍스처는 사진 자체의 해상도로 만들어지므로, 크고 선명한 사진은 이미 필요 이상의 디테일을 갖고 있어 이 기능은 우리가 줄인 것을 다시 키우는 것에 불과합니다. 사진이 충분히 크면 자동으로 건너뛰므로 켜 두어도 다운로드 외에는 비용이 들지 않습니다.
texture_upscaler아니요ultrasharpUltraSharp: preferred detail, private NonCommercial use with terms acceptance. x4plus: BSD-3-Clause alternative. Used only when sharpening a small photo is enabled.

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": "triposg-1-5b-i2m",
  "job_spec": {
    "input_image_url": "https://…/your-input.png",
    "remove_background": true,
    "steps": 50,
    "guidance_scale": 7,
    "grid_resolution": 192,
    "texture": true,
    "texture_upscale": false,
    "texture_upscaler": "ultrasharp"
  }
}'
GEThttps://cp.meshlabs.cloud/v1/organizations/jobs/{job_id}

status이(가) 최종 상태(COMPLETED, FAILED, CANCELED 또는 MODERATION_BLOCKED)가 될 때까지 같은 API 키로 폴링하세요. 콘텐츠 검토가 활성화된 경우, 작업은 컴퓨팅 대기열에 들어가기 전에 MODERATION_PENDING 상태로 시작할 수 있습니다. 완료된 작업의 각 출력에는 사전 서명된 download_url 값이 포함됩니다.

생성 응답

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "workload_type": "triposg-1-5b-i2m",
  "status": "PENDING",
  "job_spec_json": {
    "input_image_url": "https://…/your-input.png",
    "remove_background": true,
    "steps": 50,
    "guidance_scale": 7,
    "grid_resolution": 192,
    "texture": true,
    "texture_upscale": false,
    "texture_upscaler": "ultrasharp"
  },
  "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": "triposg-1-5b-i2m",
  "status": "COMPLETED",
  "job_spec_json": {
    "input_image_url": "https://…/your-input.png",
    "remove_background": true,
    "steps": 50,
    "guidance_scale": 7,
    "grid_resolution": 192,
    "texture": true,
    "texture_upscale": false,
    "texture_upscaler": "ultrasharp"
  },
  "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>"
}

사진 한 장을 업로드하면 3D 메시(GLB)를 다운로드할 수 있습니다. 피사체는 배경에서 오려냅니다. 색상은 사진에서 가져오며, 촬영한 면은 선명하고 반대편은 더 부드러우며 메탈릭이나 러프니스 맵은 없습니다. 휴대폰을 포함해 연결한 기기에서 무료로 이미지를 3D로 만들어 보세요. 처음 실행할 때는 모델을 내려받으며, 이후 사진은 더 빠르게 시작됩니다. 고급 옵션에서 오려내기와 텍스처를 끌 수 있고, 피사체가 프레임에서 너무 작을 때는 더 큰 텍스처를 켤 수 있습니다.