3D
TripoSG da immagine a 3D
Trasforma una foto in una mesh 3D da scaricare, anche su un telefono.
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.
Licenze del modello
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.
Riferimento API
Invia tramite REST
Usa la tua chiave API personale (msk_…) per creare job per questo workload dai tuoi strumenti. I job avviati in questo modo vengono eseguiti sugli stessi dispositivi che hai collegato in I tuoi dispositivi: almeno uno deve essere online.
https://cp.meshlabs.cloud/v1/organizations/jobsAutenticati con X-Organization-Api-Key: msk_your_personal_api_key. Il nome dell'intestazione corrisponde a quello delle chiavi dell'organizzazione; le chiavi personali usano lo stesso endpoint.
POST https://cp.meshlabs.cloud/v1/organizations/job-inputs/presign con la stessa chiave API, carica il tuo file su upload_url restituito, poi passa download_url in job_spec (ad esempio come input_image_url).Corpo della richiesta
{
"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"
}
}Campi di job_spec
| Campo | Obbligatorio | Predefinito | Descrizione |
|---|---|---|---|
input_image_url | Sì | — | Una foto o un render di un singolo oggetto. Il soggetto viene ritagliato automaticamente, ritagliato in quadrato e ridimensionato a 224x224, quindi un solo soggetto ben distinto dà la geometria migliore: le scene affollate e gli oggetti multipli confondono il ritaglio. Un PNG che ha già la trasparenza salta il passaggio di ritaglio ed è l'input più affidabile in assoluto. |
remove_background | No | true | Esegue il modello di segmentazione quando l'immagine non ha una trasparenza propria. Disattivalo per un'immagine che è già un ritaglio pulito su bianco, o quando il soggetto riempie l'inquadratura. |
steps | No | 50 | Passaggi rectified-flow. Sotto circa 16 la forma è riconoscibile ma perde il rilievo fine; sopra il valore predefinito smette di cambiare. |
guidance_scale | No | 7 | Quanto la mesh segue l'immagine di riferimento. |
seed | No | — | Seed casuale per una generazione riproducibile. |
grid_resolution | No | 192 | Risoluzione del campo da cui viene estratta la superficie. Il costo cresce con il cubo: 256 è circa 2,4 volte il lavoro del valore predefinito, per una differenza che per lo più non sopravvive alla levigatura. |
texture | No | true | Proietta la foto sulla mesh come texture del colore di base. Il lato mostrato dalla foto viene nitido; il lato opposto è una sbavatura del colore più vicino della silhouette, perché una sola immagine non lo vede. Disattivalo per una mesh grigia semplice: file più piccolo e scelta giusta se intendi applicare tu la texture. |
texture_upscale | No | false | Esegue un passaggio di super risoluzione 4x sul soggetto prima di proiettarlo. Ha senso solo quando il soggetto è piccolo nell'inquadratura: la texture viene costruita alla risoluzione della foto stessa, quindi una foto grande e chiara ha già più dettaglio di quanto ne contenga e questo non farebbe che ingrandire il nostro stesso ridimensionamento. Viene saltato automaticamente quando la foto è abbastanza grande, quindi lasciarlo attivo costa solo un download. |
texture_upscaler | No | 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}Fai polling con la stessa chiave API finché status non è terminale (COMPLETED, FAILED, CANCELED o MODERATION_BLOCKED). Quando la moderazione dei contenuti è abilitata, i job possono iniziare in MODERATION_PENDING prima di entrare nella coda di calcolo. I job completati includono valori download_url presigned su ogni output.
Risposta di creazione
{
"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"
}Risposta di completamento
{
"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>"
}Carica una foto e scarica una mesh 3D (GLB). Il soggetto viene ritagliato dallo sfondo. Il colore viene dalla foto: il lato che hai fotografato è nitido, quello opposto è più morbido e non ci sono mappe metalliche o di rugosità. Da immagine a 3D gratis sui dispositivi che colleghi, anche un telefono. La prima esecuzione scarica il modello; le foto successive partono più velocemente. Le opzioni avanzate disattivano il ritaglio e la texture, e attivano una texture più grande quando il soggetto è troppo piccolo nell'inquadratura.