3D
TripoSG Görselden 3D'ye
Bir fotoğrafı, telefonda da olmak üzere indirebileceğiniz bir 3D mesh'e dönüştürün.
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.
Model lisansları
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 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.
https://cp.meshlabs.cloud/v1/organizations/jobsX-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.
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": "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 alanları
| Alan | Zorunlu | Varsayılan | Açıklama |
|---|---|---|---|
input_image_url | Evet | — | Tek bir nesnenin fotoğrafı veya render'ı. Konu otomatik olarak kesilir, kare kırpılır ve 224x224'e yeniden boyutlandırılır; bu yüzden tek bir net konu en iyi geometriyi verir — karmaşık sahneler ve birden fazla nesne kesmeyi şaşırtır. Zaten şeffaflığı olan bir PNG kesme adımını atlar ve tüm girdilerin en güveniliridir. |
remove_background | Hayır | true | Görselin kendi şeffaflığı olmadığında segmentasyon modelini çalıştırın. Beyaz üzerinde zaten temiz bir kesit olan bir görsel için veya konu kadrajı doldurduğunda bunu kapatın. |
steps | Hayır | 50 | Rectified-flow adımları. Yaklaşık 16'nın altında şekil tanınabilir kalır ama ince kabartma kaybolur; varsayılanın üzerinde değişmeyi bırakır. |
guidance_scale | Hayır | 7 | Mesh'in referans görseli ne kadar yakından izlediği. |
seed | Hayır | — | Tekrarlanabilir üretim için rastgele seed. |
grid_resolution | Hayır | 192 | Yüzeyin çıkarıldığı alanın çözünürlüğü. Maliyet küple artar: 256, çoğunlukla düzeltmeden sonra kalmayan bir fark için varsayılanın kabaca 2,4 katı iştir. |
texture | Hayır | true | Fotoğrafı mesh'e temel renk dokusu olarak yansıtın. Fotoğrafın gösterdiği yüz keskin çıkar; uzak yüz, tek bir görsel onu göremediği için en yakın siluet renginin bir lekesidir. Düz gri mesh için bunu kapatın — daha küçük dosya ve onu kendiniz dokulandıracaksanız doğru seçimdir. |
texture_upscale | Hayır | false | Yansıtmadan önce konu üzerinde 4x süper çözünürlük geçişi çalıştırın. Yalnızca konu kadrajda küçük olduğunda değerlidir — doku fotoğrafın kendi çözünürlüğünde oluşturulur; bu nedenle büyük ve net bir fotoğraf zaten tuttuğundan fazla ayrıntıya sahiptir ve bu yalnızca kendi küçültmemizi büyütür. Fotoğraf yeterince büyük olduğunda otomatik olarak atlanır; bu nedenle açık bırakmanın bir indirme dışında maliyeti yoktur. |
texture_upscaler | Hayır | 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 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": "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"
}Tamamlanma yanıtı
{
"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>"
}Bir fotoğraf yükleyin ve bir 3D mesh (GLB) indirin. Konu arka plandan kesilir. Renk fotoğraftan gelir: fotoğrafladığınız yüz keskindir, uzak yüz daha yumuşaktır ve metalik veya pürüzlülük haritaları yoktur. Telefon dahil, bağladığınız cihazlarda ücretsiz görselden 3D'ye. İlk çalıştırmada model indirilir; sonraki fotoğraflar daha hızlı başlar. Gelişmiş seçenekler kesmeyi ve dokuyu kapatır, konu kadrajda çok küçük olduğunda ise daha büyük bir dokuyu açar.