3D
TripoSG képből 3D
Alakítson egy fotót letölthető 3D hálóvá, telefonon is.
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.
Modelllicencek
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-referencia
Beküldés REST-en keresztül
Személyes API-kulcsával (msk_…) saját eszközeiből is létrehozhat feladatokat ehhez a munkaterheléshez. Az így indított feladatok ugyanazokon az eszközökön futnak, amelyeket itt csatlakoztatott: Az Ön eszközei — legalább egynek online kell lennie.
https://cp.meshlabs.cloud/v1/organizations/jobsHitelesítés ezzel: X-Organization-Api-Key: msk_your_personal_api_key. A fejléc neve megegyezik a szervezeti kulcsokéval; a személyes kulcsok ugyanazt a végpontot használják.
POST https://cp.meshlabs.cloud/v1/organizations/job-inputs/presign végpontot ugyanazzal az API-kulccsal, töltse fel a fájlt a visszaadott upload_url címre, majd adja át a(z) download_url értéket a(z) job_spec mezőben (például input_image_url néven).Kéréstörzs
{
"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 mezői
| Mező | Kötelező | Alapértelmezett | Leírás |
|---|---|---|---|
input_image_url | Igen | — | Egyetlen tárgyról készült fotó vagy renderelés. Az alanyt automatikusan kivágja, négyzetre vágja, és 224x224-re méretezi, így egyetlen, jól felismerhető alany adja a legjobb geometriát – a zsúfolt jelenetek és a több tárgy összezavarja a kivágást. Az eleve átlátszóságot tartalmazó PNG kihagyja a kivágási lépést, és az összes közül a legmegbízhatóbb bemenet. |
remove_background | Nem | true | Futtassa a szegmentálási modellt, ha a képnek nincs saját átlátszósága. Kapcsolja ki olyan képnél, amely már tiszta, fehér hátterű kivágás, vagy ha az alany kitölti a képkivágást. |
steps | Nem | 50 | Rectified-flow lépések. Körülbelül 16 alatt az alak felismerhető, de elveszti a finom domborzatot; az alapérték felett már nem változik. |
guidance_scale | Nem | 7 | Mennyire követi a háló szorosan a referenciaképet. |
seed | Nem | — | Véletlen seed a reprodukálható generáláshoz. |
grid_resolution | Nem | 192 | Annak a mezőnek a felbontása, amelyből a felületet kinyeri. A költség a kockával nő: a 256 nagyjából 2,4-szer annyi munka, mint az alapérték, olyan különbségért, amely a simítást többnyire nem éli túl. |
texture | Nem | true | A fotót alapszín-textúraként vetíti a hálóra. A fotón látható oldal éles lesz; a túloldal a legközelebbi körvonal színének elmosódása, mert egyetlen kép nem látja. Kapcsolja ki sima szürke hálóhoz – kisebb fájl, és a helyes választás, ha saját maga fogja textúrázni. |
texture_upscale | Nem | false | 4x szuperfelbontási menetet futtat az alanyon a vetítés előtt. Csak akkor éri meg, ha az alany kicsi a képkivágásban – a textúra a fotó saját felbontásában készül, így egy nagy, jól felismerhető fotó már több részletet tartalmaz, mint amennyit tartani tud, és ez csak a saját lekicsinyítésünket skálázná fel. Ha a fotó elég nagy, automatikusan kimarad, így a bekapcsolva hagyás csak egy letöltésbe kerül. |
texture_upscaler | Nem | 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}Kérdezze le ugyanazzal az API-kulccsal, amíg a(z) status végállapotba nem kerül (COMPLETED, FAILED, CANCELED vagy MODERATION_BLOCKED). Ha a tartalommoderálás engedélyezve van, a feladatok MODERATION_PENDING állapotban indulhatnak, mielőtt bekerülnek a számítási sorba. A befejezett feladatok minden kimenetén előre aláírt download_url értékek szerepelnek.
Létrehozási válasz
{
"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"
}Befejezési válasz
{
"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>"
}Töltsön fel egy fotót, és töltsön le egy 3D hálót (GLB). Az alanyt kivágja a háttérből. A szín a fotóból származik: a lefényképezett oldal éles, a túloldal lágyabb, és nincsenek fémes vagy érdességi térképek. Ingyenes képből 3D az Ön által csatlakoztatott eszközökön, telefont is beleértve. Az első futtatáskor letöltődik a modell; a későbbi fotók gyorsabban indulnak. A speciális beállításokkal kikapcsolható a kivágás és a textúra, és nagyobb textúra kapcsolható be, ha az alany túl kicsi a képkivágásban.