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.
API 레퍼런스
REST로 제출
개인 API 키(msk_…)를 사용하여 내 도구에서 이 워크로드의 작업을 생성하세요. 이렇게 시작한 작업은 내 기기에서 연결한 기기와 동일한 기기에서 실행되며, 최소 한 대는 온라인이어야 합니다.
https://cp.meshlabs.cloud/v1/organizations/jobsX-Organization-Api-Key: msk_your_personal_api_key로 인증합니다. 헤더 이름은 조직 키와 같으며, 개인 키도 같은 엔드포인트를 사용합니다.
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 | 아니요 | 50 | Rectified-flow 단계 수입니다. 약 16 미만에서는 형태는 알아볼 수 있지만 미세한 굴곡이 사라지고, 기본값을 넘으면 더 이상 달라지지 않습니다. |
guidance_scale | 아니요 | 7 | 메시가 참조 이미지를 얼마나 충실히 따를지 정합니다. |
seed | 아니요 | — | 재현 가능한 생성을 위한 랜덤 시드입니다. |
grid_resolution | 아니요 | 192 | 표면을 추출하는 필드의 해상도입니다. 비용은 세제곱에 비례해 증가합니다. 256은 기본값의 약 2.4배의 작업량이지만, 그 차이는 대부분 스무딩을 거치면 남지 않습니다. |
texture | 아니요 | true | 사진을 메시에 기본 색상 텍스처로 투영합니다. 사진에 보이는 면은 선명하게 나오고, 반대편은 한 장의 이미지로는 볼 수 없으므로 가장 가까운 실루엣 색상이 번진 모양이 됩니다. 단색 회색 메시를 원하면 끄세요. 파일이 더 작아지며 직접 텍스처를 입힐 계획이라면 알맞은 선택입니다. |
texture_upscale | 아니요 | false | 투영하기 전에 피사체에 4배 초해상도 패스를 실행합니다. 피사체가 프레임에서 작을 때만 가치가 있습니다. 텍스처는 사진 자체의 해상도로 만들어지므로, 크고 선명한 사진은 이미 필요 이상의 디테일을 갖고 있어 이 기능은 우리가 줄인 것을 다시 키우는 것에 불과합니다. 사진이 충분히 크면 자동으로 건너뛰므로 켜 두어도 다운로드 외에는 비용이 들지 않습니다. |
texture_upscaler | 아니요 | ultrasharp | UltraSharp: 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"
}
}'https://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로 만들어 보세요. 처음 실행할 때는 모델을 내려받으며, 이후 사진은 더 빠르게 시작됩니다. 고급 옵션에서 오려내기와 텍스처를 끌 수 있고, 피사체가 프레임에서 너무 작을 때는 더 큰 텍스처를 켤 수 있습니다.